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PREFACE 


This update to the 4.2 distribution of August 1983 provides substantially improved performance, reliability, and secu- 
rity, the addition of Xerox Network System (NS) to the set of networking domains, and partial support for the VAX 
8600 and MICROVAXII. 


We were greatly assisted by the DEC UNIX Engineering group who provided two full time employees, Miriam Amos 
and Kevin Dunlap, to work at Berkeley. They were responsible for developing and debugging the distributed domain 
based name server and integrating it into the mail system. Mt Xinu provided the bug list distribution service as well as 
donating their MICROVAXII port to 4.3BSD. Drivers for the MICROVAXII were done by Rick Macklem at the 
University of Guelph. Sam Leffler provided valuable assistance and advice with many projects. Keith Sklower coordi- 
nated with William Nesheim and J. Q. Johnson at Cornell, and Chris Torek and lames O’Tools atthe University of 
Maryland to do the Xerox Network Systems implemeniation. Robert Elz at the Universit of Melbourne contributed 
greatly to the performance work in the kemel. Donn Sceley and Jay Lepreau at the University of Utah relentlessly 
dealt with a miriad of details; Donn completed the unfinished performance work orn Fortran 77 and fixed numerous C 
compiler bugs. Ralph Campbell handled innumerable questions and problem reports and had time left to write rdist. 
George Goble was invaluable in shaking out the bugs on his production systems long before we were confident enough 
to inflict it on our users. Bill Shannon at Sun Microsystems has been helpful in providing us with bug fixes and 
improvements. Tom Fezrin, ‘a his capacity as Boar? Member of Usenix Association, handled the logistics of large- 
scale reproduction of the 4.28SD and 4.3BSD manuals. Mark Seiden helped with tie typesetting and indexing of the 
4.3BSD manuals. Special mention goes to Bob Henry for keeping ucbvax ruaniag in spite of new and improved 
software and an ever increasing mail, news, and uucp load. 


Numerous others contributed their time and energy in creating the user contributed software for the release. As always, 
we are grateful to the UNIX user community for encouragement and support. 


Once again, the financi«i support of the Defense Advanced Research Projects Agency is gratefully acknowledged. 


M. K. McKusick 
M. 5. Karels 
J.M. Bicom 


Preface to the 4.2 Berkley distribution 


This update to the 4.1 distribution of June 1981 provides support for the VAX 11/73(, full networking and interprocess 
communication support, an entirely new file system, and many other new features. Ji is certainly the most ambitious 
release of software ever prepared here and tepresenis many man-years of work. Bill Shannon (both at DEC and at Sun 
Microsystems) and Robert Elz of the University of Melbourne contributed greatly io this distribution through new dev- 
ice drivers and painful debugging episodes. Rob Gurwitz of BBN wrote the initial version of the code upon which the 
current networking support is based. Eric Allman of Britton-Lee donated countless hours to the mail system. Bill 
Croft (both at SRI and Sun Microsystems) aided in the debugging and develop-ment of the networking facilities. 
Dennis Ritchie of Bell Laboratories also contributed greatly to this distribution, providing vaiuable advise and gui- 
dance. Helge Skrivervik worked on the device drivers which enabled the distribution to be delivered with a TUS8 con- 
sole cassette and RX01 console flopppy disk, and rewrote majoy portions of the standaione i/o ee to support for- 
matting of non-DEC peripherals. 


Numerous others contributed their time and energy in organizing the user software for release, while many groups of 
people on campus suffered patiently through the low spots of development. As always, we are grateful to the UNIX 
user community for encouragement and support. 


Once again, the financial support of the Defense Advanced Research Projects Agency is gratefully acknowledged. 
S. J. Leffier 


W. N. Joy 
M. K. McKusick 


Preface to the 4.1 Berkeley distribution 


This update to the fourth distribution of November 1980 provides support for the VAX 11/750 and for the full intercon- 
nect architecture of the VAX 11/780. Robert Elz of the University of Melbourne contributed greatly to this distribution 
especially in the boot-time system configuration code; Bill Shannon of DEC supplied us with the implementation of 
DEC standard bad block handling. The research group at Bell Laboratories and DEC Merrimack provided us with 
access to 11/750’s in order to debug its support. . 


Other individuals too numerous to mention provided us with bug reports, fixes and other enhancements which are 
reflected in the system. We are grateful to the UNIX user community for encouragement and support. 


The financial support of the Defence Advanced Research Projects Agency in support of this work is gratefully ack- 
nowledged. 


W. N. Joy 
R. S. Fabry 
K. Sklower 


Preface to the Fourth Berkeley distribution 


This manual reflects the Berkeley system mid-October, 1980. A large amount of tuning has been done in the system 
since the last release; we hope this provides as noticeable an improvement for you as it did for us. This release. finds 
the system in transition; a number of facilities have been added in experimental versions (job control, resource limits) 
and the implementation of others is imminent (shared-segments, higher performance from the file system, etc.). Appli- 
cations which use facilities that are in transition should be aware that some of the system calls and library routines will 
change in the near future. We have tried to be conscientious and make it very clear where this is likely. 


A new group has been formed at Berkeley, to assume responsibility for the future development and support of a version 
- of UNIX on the VAX. The group has received funding from the Defense Advanced Research Projects Agency 
(DARPA) to supply a standard version of the system to DARPA contractors. The same version of the system will be 
made available to other licensees of UNIX on the VAX for a duplication charge. We gratefully acknowledge the sup- 
port of this contract. 


We wish to acknowledge the contribution of a number of individuals to the the system. | e, 


We would especially like to thank Jim Kulp of IASA, Laxenburg Austria and his colleagues, who first put job control 
facilities into UNIX; Eric Allman, Robert Henry, Peter Kessler and Kirk McKusick, who contributed major new pieces 
of software; Mark Horton, who contributed to the improvement of facilities and substantially improved the quality of 
our bit-mapped fonts, our hardware support staff: Bob Kridle, Anita Hirsch, Len Edmondson and Fred Archibald, who 
helped us to debug a number of new peripherals; Ken Arnold who did much of the leg-work in getting this version of 
the manual prepared, and did the final editing of sections 2-6, some special individuals within Bell Laboratories: Greg 
Chesson, Stuart Feldman, Dick Haight, Howard Katseff, Brian Kernighan, Tom London, John Reiser, Dennis Ritchie, 
Ken Thompson, and Peter Weinberger who helped out by answering questions; our excellent local DEC field service 
people, Kevin Althaus and Frank Chargois who kept our machine running virtually all the time, and fixed it quickly 
when things broke; and, Mike Accetta of Carnegie-Mellon University, Robert Elz of the University of Melbourne, 
George Goble of Purdue University, and David Kashtan of the Stanford Research Institute for their technical advice 
and support. 


Special thanks to Bill Munson of DEC who helped by augmenting our computing facility and to Eric Allman for care- 
fully proofreading the ‘‘last’’ draft of the manual and finding the bugs which we knew were there but couldn’t see. 


We dedicate this to the memory of David Sakrison, late chairman of our department, who gave his support to the estab- 
lishment of our VAX computing facility, and to our department as a whole. 


W. N. Joy 
O. Babao'glu 
R. S. Fabry 
K. Sklower 


Preface to the Third Berkeley distribution 


This manual reflects the state of the Berkeley system, December 1979. We would like to thank all the people at Berke- 
ley who have contributed to the system, and particularly thank Prof. Richard Fateman for creating and administrating a 
hospitable environment, Mark Horton who helped prepare this manual, and Eric Allman, Bob Kridle, Juan Porcar and 
Richard Tuck for their contributions to the kernel. . 


The cooperation of Bell Laboratories in providing us with an early version of UNIX/32V is greatly appreciated. We 
would especially like to thank Dr. Charles Roberts of Bell Laboratories for helping us obtain this release, and ack- 
nowledge T. B. London, J. F. Reiser, K. Thompson, D. M. Ritchie, G. Chesson and H. P. Katseff for their advice and 
support. 


W.N. Joy 
O. Babao*glu 


Preface to the UNIX/32V distribution 


The UNIX operating system for the VAX*-11 provides substantially the same facilities as the UNIX system for the 
PDP*-11. 


We acknowledge the work of many who came before us, and particularly thank G. K. Swanson, W. M. Cardoza, D. K. 
Sharma, and J. F. Jarvis for assistance with the implementation for the VAX-11/780. 


T. B. London 
J. F. Reiser 


Preface to the Seventh Edition 


Although this Seventh Edition no longer bears their byline, Ken Thompson and Dennis Ritchie remain the fathers and 
preceptors of the UNIX time-sharing system. Many of the improvements here described bear their mark. Among many, 
many other people who have contributed to the further flowering of UNIX, we wish especially to acknowledge the con- 
tributions of A. V. Aho, S. R. Bourne, L. L. Cherry, G. L. Chesson, S. I. Feldman, C. B. Haley, R. C. Haight, S. C. 
Johnson, M. E. Lesk, T. L. Lyon, L. E. McMahon, R. Morris, R. Muha, D. A. Nowitz, L. Wehr, and P. J. Weinberger. 
We appreciate also the effective advice and criticism of T. A. Dolotta, A. G. Fraser, J. F. Maranzano, and J. R. Mashey; 
and we remember the important work of the late Joseph F. Ossanna. 


W. Kermighan 
D. 


B. 
M. D. Mcliroy 


t UNIX is a trademark of Bell Laboratories. 
*VAX and PDP are Trademarks of Digital Equipment Corporation. 
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INTRODUCTION TO USER’S REFERENCE MANUAL 


The documentation has been reorganized for 4.3BSD in a format similar to the one used for the Usenix 
4.2BSD manuals. It is divided into three sets; each set consists of one or more volumes. The abbreviations 
for the volume names are listed in square brackets; the abbreviations for the manual sections are listed in 
parenthesis. 


I. User’s Documents 

User’s Reference Manual [URM] 
Commands (1) 
Games (6) 
Macro packages and language conventions (7) 

User’s Supplementary Documents [USD] 
Getting Started 
Basic Utilities 
Communicating with the World 
Text Editing 
Document Preparation 
Amusements 


I]. Programmer’s Documents 

Programmer’s Reference Manual [PRM] 
System calls (2) 
Subroutines (3) 
Special files (4) 
File formats and conventions (5) 

Programmer’s Supplementary Documents, Volume 1 [PS1] - 
Languages in common use 
General Reference 
Programming Tools 
Programming Libraries 

Programmer’s Supplementary Documents, Volume 2 [PS2] _ 
Documents of Historic Interest 
Other Languages 
Database Management 


Il. System Manager’s Manual [SMM] 
Maintenance commands (8) 
System Installation and Administration 
Supporting Documentation 


References to individual documents are given as ‘‘volume:document’’, thus USD:1 refers to the first docu- 
ment in the ‘‘User’s Supplementary Documents’’. References to manual pages are given as 
““name(section)’’ thus sh(1) refers to the shell manual entry in section 1. 


The manual pages give descriptions of the publicly available features of the UNIX/32VT system, as extended 
to provide a virtual memory environment and other enhancements at the University of California. They do 


+ UNIX is a trademark of Bell Laboratories. 


not attempt to provide perspective or tutorial information about the UNIX operating system, its facilities, or 
its implementation. Various documents on those topics are contained in the ‘‘UNIX User’s Supplementary 
Documents’’ (USD), the ‘‘UNIX Programmer’s Supplementary Documents’’ (PS1 and PS2), and ‘‘UNIX 
System Manager’s Manual’’ (SMM). In particular, for an overview see ‘‘The UNIX Time-Sharing Sys- 
tem’’ (PS2:1) by Ritchie and Thompson; for a tutorial see ‘‘UNIX for Beginners’? (USD:1) by Kernighan, 
and for an guide to the new features of this virtual version, see ‘‘Berkeley Software Architecture Manual 
(4.3 Edition)’’ (PS1:6). 

Within the area it surveys, this volume attempts to be timely, complete and concise. Where the latter two 
objectives conflict, the obvious is often left unsaid in favor of brevity. It is intended that each program be 
described as it is, not as it should be. Inevitably, this means that various sections will soon be out of date. 


Commands are programs intended to be invoked directly by the user, in contrast to subroutines, that are 
intended to be called by the user’s programs. User commands are described in URM section 1. Com- 
mands generally reside in directory /bin (for bin ary programs). Some programs also reside in / usr/bin, 
/usrlucb, or /usr/ new, to save space in / bin. These directories are searched automatically by the command 
interpreters. = 

Games have been relegated to URM section 6 and /usr/ games, to keep them from contaminating the more 
staid information of URM section 1. 


Miscellaneous collection of information necessary for writing in various specialized languages such as 
character codes, macro packages for typesetting, etc is contained in URM section 7. 


System calls are entries into the UNIX supervisor. The system call interface is identical to a C language 
procedure call; the equivalent C procedures are described in PRM section 2. 


An assortment of subroutines is available; they are described in PRM section 3. The primary libraries in 
which they are kept are described in intro(3). The functions are described in terms of C; those that will 
work with Fortran are described in intro(3f). 


PRM section 4 discusses the characteristics of each system ‘‘file’’ that refers to an I/O device. The names 
in this section refer to the DEC device names for the hardware, instead of the names of the special files 
themselves. : 


The file formats and conventions (PRM section 5) documents the structure of particular kinds of files; for 
example, the form of the output of the loader and assembler is given. Excluded are files used by only one 
command, for example the assembler’s intermediate files. 


Commands and procedures intended for use primarily by the system administrator are described in SMM 
section 8. The commands and files described here are almost all kept in the directory /etc. 


Each section consists of independent entries of a page or so each. The name of the entry is in the upper 
corners of its pages, together with the section number, and sometimes a letter characteristic of a sub- 
category, e.g. graphics is 1G, and the math library is 3M. Entries within each section are alphabetized. 
except for PRM section 3f which appears after the rest of PRM section 3. The page numbers of each entry 
Start at 1; it is infeasible to number consecutively the pages of a document like this that is republished in 
many variant forms. . 


All entries are based on a common format; not all subsections always appear. 


_ The name subsection lists the exact names of the commands and subroutines covered under the entry 
and gives a short description of their purpose. 


- The synopsis summarizes the use of the program being described. A few conventions are used, par- 
ticularly in the Commands subsection: 


Boldface words are considered literals, and are typed just as they appear. 


Square brackets [ ] around an argument show that the argument is optional. When an argu- 
ment is given as ‘‘name’’, it always refers to a file name. 

Ellipses ‘*...’’ are used to show that the previous argument-prototype may be repeated. 

A final convention is used by the commands themselves. An argument beginning with a minus 
sign ‘‘—’’ usually means that it is an option-specifying argument, even if it appears in a posi- 
tion where a file name could appear. Therefore, it is unwise to have files whose names begin 


with 6 ou? > . 
The description subsection discusses in detail the subject at hand. 
The files subsection gives the names of files that are built into the program. 
A see also subsection gives pointers to related information. 


A diagnostics subsection discusses the diagnostic indications that may be produced. Messages that 
are intended to be self-explanatory are not listed. . 


The bugs subsection gives known bugs and sometimes deficiencies. Occasionally the suggested fix 
is also described. 
At the beginning of URM is a table of contents, organized by section and alphabetically within each sec- 
tion. There is also a permuted index derived from the table of contents. Within each index entry, the title 
of the writeup to which it refers is followed by the appropriate section number in parentheses. This fact is 
important because there is considerable name duplication among the sections, arising principally from 
commands that exist only to exercise a particular system call. 


HOW TO GET STARTED 


This section sketches the basic information you need to get started on UNIX; how to log in and log out, 
how to communicate through your terminal, and how to run a program. See ‘‘UNIX for Beginners’’ in 
(USD:1) for a more complete introduction to the system. 


Logging in. Almost any ASCII terminal capable of full duplex operation and generating the entire charac- 
ter set can be used. You must have a valid user name, which may be obtained from the system administra- 
tion. If you will be accessing UNIX remotely, you will also need to obtain the telephone number for the 
system that you will be using. 


After a data connection is established, the login procedure depends on what type of terminal you are using 
and local system conventions. If your terminal is directly connected to the computer, it generally runs at 
9600 or 19200 baud. If you are using a modem running over a phone line, the terminal must be set at the 
speed appropriate for the modem you are using, typically 300, 1200, or 2400 baud. The half/full duplex 
switch should always be set at full-duplex. (This switch will often have to be changed since many other 
systems require half-duplex). 

When a connection is established, the system types ‘‘login:’’; you type your user name, followed by the 
“‘return’’ key. If you have a password, the system asks for it and suppresses echo to the terminal so the 
password will not appear. After you have logged in, the ‘‘return’’, ‘“‘new line’’, or ‘‘linefeed’’ keys will 
give exactly the same results. A message-of-the-day usually greets you before your first prompt. 


If the system types out a few garbage characters after you have established a data connection (the ‘‘login:”’ 
message at the wrong speed), depress the ‘‘break’’ (or “‘interrupt’’) key. This is a speed-independent sig- 
nal to UNIX that a different speed terminal is in use. The system then will type ‘‘login:,’’ this time at 
another speed. Continue depressing the break key until ‘‘login:’’ appears clearly, then respond with your 
user name. 


For all these terminals, it is important that you type your name in lower-case if possible; if you type upper- 
case letters, UNIX will assume that your terminal cannot generate lower-case letters and will translate all 
subsequent lower-case letters to upper case. 


The evidence that you have successfully logged in is that a shell program will type a prompt (‘‘$’’ or 
“*%’’) to you. (The shells are described below under ‘‘How to run a program.’’) 


For more information, consult tset(1), and stty(1), which tell how to adjust terminal behavior; getty(8) 
discusses the login sequence in more detail, and tty(4) discusses terminal I/O. 


Logging out. There are three ways to log out: 


By typing ‘“‘logout’’ or an end-of-file indication (EOT character, control-D) to the shell. The shell 
will terminate and the ‘‘login:’’ message will appear again. 


You can log in directly as another user by giving a login(1) command. 


If worse comes to worse, you can simply hang up the phone; but beware — some machines may lack 
the necessary hardware to detect that the phone has been hung up. Ask your system administrator if 
this is a problem on your machine. 


How to communicate through your terminal. When you type characters, a gnome deep in the system gath- 
ers your characters and saves them in a secret place. The characters will not be given to a program until 
you type a return (or newline), as described above in Logging in. 


UNIX terminal I/O is full-duplex. It has full read-ahead, which means that you can type at any time, even 
while a program is typing at you. Of course, if you type during output, the printed output will have the 
input characters interspersed. However, whatever you type will be saved up and interpreted in correct 
sequence. There is a limit to the amount of read-ahead, but it is generous and not likely to be exceeded 
unless the system is in trouble. When the read-ahead limit is exceeded, the system throws away all the 
saved characters (or beeps, if your prompt was a ‘‘%’’). 


The delete (DEL) character in typed input kills all the preceding characters in the line, so typing mistakes 
can be repaired on a single line. Also, the backspace character (control-H) erases the last character typed. 
Tset(1) or stty(1) can be used to change these defaults. Successive uses of backspace erases characters 
back to, but not beyond, the beginning of the line. DEL and backspace can be transmitted to a program by 
preceding them with ‘‘\’’. (So, to erase “‘\’’, you need two backspaces). 


An interrupt signal is sent to a program by typing control-C or the ‘‘break’’ key which is not passed to pro- 
grams. This signal generally causes whatever program you are running to terminate. It is typically used to 
stop a long printout that you do not want. However, programs can arrange either to ignore this signal alto- 
gether, or to be notified when it happens (instead of being terminated). The editor, for example, catches 
interrupts and stops what it is doing, instead of terminating, so that an interrupt can be used to halt an editor 
printout without losing the file being edited. The interrupt character can also be changed with tset(1) or 
stty(1). 

It is also possible to suspend output temporarily using “S (control-S) and later resume output with “Q 
(control-Q). Output can be crown away without interrupting the program by typing “O (control-O); see 
tty(4). 

The quit signal is generated by typing the ASCII FS character. (FS appears many places on different termi- 
nals, most Commonly as control-\ or control-|.) It not only causes a running program to terminate but also 
generates a file with the core image of the terminated process. Quit is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent about whether you have a termi- 
nal with the newline function or whether it must be simulated with carriage-return and line-feed. In the 
latter case, all input carriage returns are turned to newline characters (the standard line delimiter) and both 
a Carriage return and a line feed are echoed to the terminal. If you get into the wrong mode, the reset(1) 
command will rescue you. If the terminal does not appear to be echoing anything that you type, it may be 
stuck in ‘‘no-echo’’ or ‘‘raw’’ mode. Try typing ‘‘(control-J)reset(control-J)’’ to recover. 


Tab characters are used freely in UNIX source programs. If your terminal does not have the tab function, 
you can arrange to have them turned into spaces during output, and echoed as spaces during input. The 
system assumes that tabs are set every eight columns. Again, the tset(1) or stty(1) command can be used to 
change these defaults. Tse#(1) can be used to set the tab stops automatically when necessary. 


How to run a program; the shells. When you have successfully logged in, a program called a shell is 
listening to your terminal. The shell reads typed-in lines, splits them up into a command name and argu- 
ments, and executes the command. A command is simply an executable program. The shell looks in 
several system directories to find the command. You can also place commands in your own directory and 
have the shell find them there. There is nothing special about system proyised commands es that they 
are kept in a directory where the shell can find them. 


The command name is always the first word on an input line; it and its arguments are separated from one 
another by spaces. 

When a program terminates, the shell will ordinarily regain control and type a prompt at you to show that it 
is ready for another command. 


The shells have many other capabilities, that are described in detail in sections sh(1) and csh(1). If the 
shell prompts you with ‘‘$’’, then it is an instance of sh(1) the standard shell provided by Bell Labs. If it 
prompts with ‘‘%’’ then it is an instance of csh(1), a shell written at Berkeley. The shells are different for 
all but the most simple terminal usage. Most users at Berkeley choose csh(1) because of the history 
mechanism and the alias feature, that greatly enhance its power when used interactively. Csh also sup- 
ports the job-control facilities; see csh(1) or the Csh introduction in USD:4 for details. 


You can change from one shell to the other by using the chsh (1) command, which takes effect at your next 
login. 

The current directory. UNIX has a file system arranged as a hierarchy of directories. When the system 
administrator gave you a user name, they also created a directory for you (ordinarily with the same name as 
your user name). When you log in, any file name you type is by default in this directory. Since you are the 
owner of this directory, you have full permission to read, write, alter, or destroy its contents. Permissions 
to have your will with other directories and files will have been granted or denied to you by their owners. 
As a matter of observed fact, few UNIX users protect their files from perusal by other users. 


To change the current directory (but not the set of permissions you were endowed with at login) use cd(1). 


Path names. To refer to files not in the current directory, you must use a path name. Full path names 
begin with ‘‘/’’, the name of the root directory of the whole file system. After the slash comes the name of 
each directory containing the next sub-directory (followed by a ‘‘/’’) until finally the file name is reached. 
For example, /usr/tmp/filex refers to the file filex in the directory tmp; tmp is itself a subdirectory of usr; 
usr springs directly from the root directory. 

If your current directory has subdirectories, the path names of files therein begin with the name of the sub- 
directory with no prefixed ‘‘/’’. 

A path name may be used anywhere a file name is required. 


Important commands that modify the contents of files are cp(1), mv(1), and rm(1), which respectively 
copy, move (i.e. rename) and remove files. To find out the status of files or directories, use /s(1). See 
mkdir (1) for making directories and rmdir (1) for destroying them. 


For a fuller discussion of the file system, see ‘‘A Fast File System for UNIX’’ (SMM:14) by McKusick, 
Joy, Leffler, and Fabry. It may also be useful to glance through PRM section 2, that discusses system calls, 
even if you do not intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use the editor ex(1) or its 
display editing alias vi(1). (The old standard editor ed(1) is also available.) The principal languages in 
UNIX are provided by the C compiler cc (1), the Fortran compiler {77(1), and its derivatives eff(1) and rat- 
for(1), the Pascal compiler pc(1), and interpreter pi(1), and the Lisp system lisp(1). User contributed 
software in the latest release of the system supports APL, B, the Functional Programming language, and 
Icon. Refer to apl(1), b(1), fp(1), and icon(1), respectively for more information about each. After the 
program text has been entered through the editor and written to a file, you can give the file to the appropri- 
ate language processor as an argument. The output of the language processor will be left on a file in the 
Current directory named ‘‘a.out’’. If the output is precious, use mv(1) to move it to a less exposed name 
after successful compilation. 


When you have finally gone through this entire process without provoking any diagnostics, the resulting 
program can be run by giving its name to the shell in response to the shell (“‘$’’ or ‘‘%”’) prompt. 


Your programs can receive arguments from the command line just as system programs do, see ‘‘UNIX 
Programming - Second Edition’’ (PS2:3), or for a more terse description execve (2). 


Text processing. Almost all text is entered through the editor ex(1) (often entered via vi(1)). The com- 
mands most often used to write text on a terminal are: cat(1), more(1), and nroff(1). 


The cat(1) command simply dumps ASCII text on the terminal, with no processing at all. More(1) is useful 
for preventing the output of a command from scrolling off the top of your screen. It is also well suited to 
perusing files. Nroff(1) is an elaborate text formatting program. Used naked, it requires careful 
forethought, but for ordinary documents it has been tamed; see me (7) and ms (7). 


Troff(1) prepares documents for a Graphics Systems phototypesetter or a Versatec Plotter; it is similar to 
nroff(1), and often works from exactly the same source text. It was used to produce this manual. 


Script(1) lets you keep a record of your session in a file, which can then be printed, mailed, etc. It provides 
the advantages of a hard-copy terminal even when using a display terminal. 


Status inquiries. Various commands exist to provide you with useful information. w(1) prints a list of 
users currently logged in, and what they are doing. date(1) prints the current time and date. /s(1) will list 
the files in your directory or give summary information about particular files. 

Surprises. Certain commands provide inter-user communication. Even if you do not plan to use them, it 
would be well to learn something about them, because someone else may aim them at you. 


To communicate with another user currently logged in, write(1) or talk(1) is used; mail(1) will leave a 
message whose presence will be announced to another user when they next log in. The write-ups in the 
manual also suggest how to respond to the these commands if you are a target. 


If you use csh(1) the key “Z (control-Z) will cause jobs to ‘“‘stop’’. If this happens before you learn about 
it, you can simply continue by saying ‘‘fg’’ (for foreground) to bring the job back. 


CONVERTING FROM 4.2BSD SYSTEMS 
A detailed list of changes from the 4.2BSD to the 4.3BSD distributions is contained in “‘Bug Fixes and 
Changes in 4.3BSD’’ (SMM:12), and ‘“Changes to the Kernel in 4.3BSD’’ (SMM:13). Detailed conver- 
sion procedures are described in ‘‘Installing and Operating 4.3BSD on the VAX’’ (SMM:1); it also 
discusses changes from pre-4.2BSD systems. 
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1ib2648: subroutines for the HP 
mset: retrieve ASCII to IBM 
database for mapping ascii keystrokes into IBM 
diff3: 

openp!l et al.: £77 library interface to p 1 o t 
sendbug: mail a system bug report to 
abort: 


abs: integer 
hypot, cabs: Euclidean distance, complex 
round-to-nearest/ fabs, floor, ceil, rint: 


accept: 


getgroups: get group 
initgroups: initialize group 
setgroups: set group 
phys: allows a process to 
access: determine 
access: determine 

ac: login 

sa, accton: system 

acct: execution 

pac: printer/plotter 

acct: turn 


8a, 

their inverses. sin, cos, tan, asin, 

asinh, 

signal: change the 

fortune: print a random, hopefully interesting, 
sd: VME SCSI disk 


swapon: 


adduser: procedure for 

swapon: specify 

ns_addr, ns_ntoa: Xerox NS(tm) 
inet_makeaddr, inet_Inaof, inet_netof: Internet 
loc: return the 

arp: 

arp: 

phys: allows a process to access physical 
mailaddr: mail 


of the system clock. 
automatically. 
admin: perform routine system 


battlestar: a tropical 
flock: apply or remove an 
lockf: provide 

basename: strip filename 
learn: computer 


L.aliases: UUCP hostname 
unalias: remove 


which: locate a program file including 
newaliases: rebuild the data base for the mail 
aliases: 

L. 

valloc: 

valloc: 
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accessibility ofafile. 2... 2 2 ew we we we we ew access(3F) 
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malloc, free, realloc, calloc, alloca: memory allocator, . . 0... 2 2 we ee eee malloc(3) 
malloc, free, realloc, calloc, alloca: memory allocator, 2... 2 6 eee ee we eee wwe ee we malioc(3) 
malloc, free, falloc: memory allocator, .... . es Bat FEY wih NO A481 Ble el ce malloc(3F) 
valloc: aligned memory allocator, 2... 2 2 ee eee ee ee ee we ew ww valloc(3) 
valloc: aligned memory allocator, . 2. 2.6. eee eee ee eee ee eee valloc(3C) 
phys: allows a process to access physical addresses. ...-... phys(3C) 
scandir, alphasort:scanadirectory. . 2.6 6 2 2 eee ee eee scandir(3) 
limit: alter per-process resource limitations. ..... . eo + + + © Ch(1) 
renice: alter priority of running processes. . . ... +--+ + > + + « Fenice(8) 
else: alternative commands. ..... +. ++ e+e «© © ee © © CSh(l) 
vacation: return ‘‘I am on vacation’’ message. . . . 1.2 2 2 ee eee - vacation(1) 
lex: generator of lexical analysis programs. . 2... 2... 2 ee ee eee eee lex(1) 
error: analyze and disperse compiler error messages. . ..-- + - error(1) 
style: analyze writing styleofadocument. ....-. + ses style(1) 
sigstack: set and/or get signal stack context. 2... 2 6 ee ee ee sigstack(2) 
worms: animate worms on a display terminal. fe. SG dehy er tate ee ee worms(6) 
rain: animated raindropedisplay. .....-..+-+-- - + « rain(6) 
bed: convert to antique media. 2... 2 2 6 1 ee ee ee ee ee ww « BCd(6) 
sticky: persistent text and append-only directories. 2... 2 6 6 2 ee ee ee +o Bticky(8) 
apply: apply a command toa set of arguments. . .. ..- 2+ + apply(1) 
apply: apply a command toa set of arguments. ...... .- apply(1) 
flock: apply or remove an advisory lock on an open file. . ..... flock(2) 
: locate commands by keyword sgn Sia a Seite: B, apropos(1) 
ar: archive and library maintainer. . 2. 2 6 ee ee ee ar(1) 
ar: archive (library) file format, 2... 2 2 2 ee ee ee ew ar(5) 
number: convert Arabic numeralsto English, . . 2... 2 2 ee ee eee number(6) 
be: arbitrary-precision arithmetic language. . . . 2... +--+ s be(1) 
graphics/ plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, closepl: ...... . plot(3X) 
tp: manipulate tape archive. . 2... 2 ee eee eee eee ee ewe tp(1) 
: ar: archive and library maintainer, ... 2... 2-6 ee eae ar(1) 
tar:tape archivefileformat . 2... 1... 2 ee ee ee eee tar(5) 
ar: archive (library) fileformat. ... 1... 2 ee ee eee ar(5) 
tar:tape archiver, 2... 2 2 2 ee eee octereet, “er set winie ie cal tek tar(1) 
ranlib: convert archives to random libraries. Brulee yeh orca! Yer Sar se. uetnel 08, Mat Me ranlib(1) 
glob: filename expand argumentlist. . . 2... 2. ee ee ee ee we eee cesh(1) 
shift: manipulate argumentlis. . 2. 2 1 8 2 ee wee te ee tw ew esh(1) 
varargs: variable argumentlist. 2... 6 6 2 eee ee we eee ee wae varargs(3) 
apply: apply a command toasetof arguments. . 2... 66 ee ee ee eee te te we apply(1) 
echo:echo arguments. . 2.2 2 0 ew ee we ee ew ee eww csh(1) 
echo:echo arguments. . 2. 2... 2 2 wee ee ee ee ee we wn echo(1) 
getarg, iargc: return command line arguments. ......... ose heer e2 © ere w Nes 8 getarg(3F) 
expr: evaluate arguments as anexpression. . . 2... 2 2 ee ee eee expr(1) 
getopt: get option letterfrom argv.  . 2. 6 2 ee ee eee ee ee ee we ees getopt(3) 
m_out, sdiv, itom: multiple precision integer arithmetic. /omin, fmin, m in, mout, omout, fmout, er a ae mp(3X) 
traper: trap arithmeticerrors. 2... 6 6 1 ew ee ee ee ee ew traper(3F) 
be: arbitrary-precision arithmetic language. . 2... 2 2 2 ee ee ee eee be(1) 

@: arithmetic on shell variables. 2... 2 1 1 we ee ee esh(1) 
arithmetic: provide drill in number facts. .........- arithmetic(6) 
arp: address resolution display and control. ........ arp(8C) 
arp: Address Resolution Protocol, . 2... ....2-2.246- arp(4P) 

ftp: ARPANET file transfer program. ....... 2-2... ftp(iC) 
biff: be notified if mail arrivesand whoitisfrom. .... 2... 2.2.2.2 ee ee biff(1) 
expr: evaluate arguments as anexpression. . . 2. 2 6 2 ee ee ww we eee expr(1) 
as: MC68000/MC68010/MC68020 assembler. .. . ~~... as(1) 
slattach: attach serial lines as network interfaces. 2... 2 2s eee eee ee ewe slattach(8C) 
asctime, timezone, tzset: convert date and time to ASCII. ctime, localtime,gmtime, ..........4.-. ctime(3) 
od: file-dump (octal, decimal, hex, ascii). . Waa ese an fe. ei ie che, ere eS wh od(1) 
ascii: map of ASCII character set. BBW HES Oe Saw et fer SS SS ascii(7) 
map3270: database for mapping ascii keystrokes intoIBM 3270 keys. ........2.4.. map3270(5) 
ascii: map of ASCII characterset. . 2... 1... 2.22 ee ascii(7) 
fdate: return date and time in an ASCII string, 2. ....02206.4 Gis PS eh ep erté fdate(3F) 
mset: retrieve ASCII to IBM 3270 keyboardmap. .......... . meset(l) 
atof, atoi, atol: convert ASCII tomumbers. 2... 2. 0 0 eee wee eee atof(3) 
ASCII. ctime, localtime, gmtime, asctime, timezone, tzset: convert date and time to oe ee «© « 6Ctime(3) 
and their inverses. sin, cos, tan, asin, acos, atan, atan2: trigonometricfunctions ....... sin(3M) 
asinh, acosh, atanh: inverse hyperbolic functions. ...... asinh(3M) 
as: MC68000/MC68010/MC68020 assembler, 2. 2 1 2 ee eee eee eee ee we as(1) 
aout: assembler and link editoroutput. .... 2.5.2.2... a.out(S) 
assert: program verification, ... 1... + 2+ ee eee assert(3) 
assert; program Verification, .. 2... +s. e eee eee assert(3X) 
setbuf, setbuffer, setlinebuf: assign bufferingtoastram. ......-++s-+-e-e... setbuf(3S) 
atrm: remove jobs spooled by at. 2. 6 6 6 ee ee ee eee eee eee eee atrm(1) 
shutdown: close down the system atagiventime. . . 2.2. see eee eee ee ene shutdown(8) 
at: execute commands atalatertime. ..6 2. 2. 6 2 2 2 ee ee ee we ee eae at(1) 
at; execute commands at a Later time. Suis! 78h erie ey, Bley ee at(1) 
nice, nohup: run a command at low priority(s h only). ... 2... 56.6222 eee nice(1) 
July 1987 - xiv - INTEGRATED SOLUTIONS 4.3 BSD 


Permuted Index 


inverses. sin, cos, tan, asin, acos, atan, atan2: trigonometric functions andtheir ..... . . sin(3M) 
sin, COs, tan, asin, acos, atan, atan2: trigonometric functions and their inverses. ...... sin(3M) 
asinh, acosh, atanh: inverse hyperbolic functions. ... 2... + see es asinh(3M) 
atof, atoi, atol: convert ASCII to sumbers. aie » « . atof(3) 
atof, atoi, atol: convert ASCII tomumbers. . . 2. 2. 1 2. ee oe - atof(3) 
atof, atoi, atol: convert ASCII to mumbers. . 2... 6 6 1 ee eee atof(3) 
interrupt. sigpause: atomically release blocked signals and waitfor ....... sigpause(2) 
aiq: print the queue of jobs waitingtoberun, ....... atq(1) 
atrm: remove jobs spooled by at. 6 6 6 we ee ee ee atrm(1) 
slattach: attach serial lines as network interfaces. . .......2.. slattach(8C) 
admin: perform routine system administration tasks automatically, ........ $3 0. Se sah Val WS eave, el eee admin(8) 
bugfiler: file bug reports in folders automatically. . 2... 1 eee eee ewe ee we bugfiler(8) 
rc: command script for suto-rebootanddaemoms. ... 2... 2. eee ee eee re(8) 
wait: await completion of process. 2... 6 2 ee ee eee es wait(1) 
awk: pattern scanning and aaa language. .... ss awk(1) 
backgammon: the game. eae: Sipe a. St ote e oe ; . . backgammon(6) 
bg: place job in background. . 2... 2 2 2 ee ee ee te ee te tes csh(1) 
wait: wait for background processes to complete. ce ew eee ew oe @ © 6CBhC) 
bad144: read/write dec standard 144 bad sectorinformation. ...... +22 + +e + + 6 « ~ badl44(8) 
badsect: create files to contain bad sectors. ..... ten Se efor, “ar ser torre, badsect(8) 
information. bad144: read/write dec standard 144 bad sector oe oe eo « © 6badl44(8) 
badsect: create files to contain bad sectors. . 2. 2. 2. 2 2 eee badsect(8) 
banner: printlarge banneron printer, . 2. 6 1 ee eee ee ee ewes banner(6) 
ee ee at aitecter- ec ie> ce - banner(6) 
gettytab: terminal configuration data base. 2... 16 2 ee ew ee err ee er ee wae gettytab(S) 
hosts: host name data base. eh Nat hs ey a BE ON, eS SOL aw, A LW aS yee, He hosts(5) 
networks: network name data base. anes e cals et sel fants PR ee ee an a eee ee ee networks(5) 
phones: remote host phone number data base. . 2... 2 2 eee eee ee ee eee ene - » phones(5) 
printcap: printer capability data base. ....2... ele as eS ee 8 . . » printcap(S) 
protocols: protocol name data base. a exer xe erie) eo ey 8, as we ee 8s a, en Wn “Oy SSS protocois(S) 
services: servicename data base. ... 2.2.2 0.02 eee se eee vreneas services(S) 
termcap: terminal capability data base. 2... 2 2 we ee we we eee we we ww wns termcap(5) 
vgrindefs: vgrind’s language definition data base. .......2.-. SG Te abet ee wx eh Wa Ter Cac verdes 2 vgrindefs(5) 
newaliases: rebuild the data base forthe mailaliasesfile. . . 2... 0 se ee eee newaliases(1) 
fetch, store, delete, firstkey, nextkey: data base subroutines. dbminit, .........0.0008-8 dbm(3X) 
dbm_nextkey, dbm_error, dbm_clearerr: data base subroutines. /dbm_delete, dbm_firstkey, ....... ndbm(3) 

vi: screen oriented (visual) display editor basedonex. 2. 2... 1. ee eee ee we we we ee ws vi(1) 
basename: strip filename affixes. . 2... 2.2. 2 ese ee basename(1) 
battlestar: a tropical adventure game. ........2.6. battlestar(6) 
be: arbitrary-precision arithmetic language. ........ be(1) 
bed: convert to antique media. 6. 2 2 2 1 ew ee ee ee bed(6) 

beopy, bemp, bzero, ffs: bit and byte string operations. .... . . . bstring(3) 
operations. bcopy, bcmp, bzero, ffs: bit and byte string ........ bstring(3) 
cb: C Deautifier «6. eae oe, Bs 8S, WO a a eb(1) 
vfont: font formats forthe Benson-Varian or Versatec. pera: SP Seite Ye 18 tek SR ewe. “we atv vfont(5) 
jO, jl, jn, yO, yl, yn: bessel functions. 2. 2... 1 1 we te ew ew tt te tw ws j0GM) 
bessel functions: of two kinds for integerorders. ...... bessel(3F) 
random, drandm, irandm: betterrandom number generator, ........500605 random(3F) 
changing/ random, srandom, initstate, setstate: better random number generator; routinesfor ..... . . random(3) 
bg: place jobin background. ..........0.0044. cesh(1) 
addbib: create orextend bibliographic database. .. 2... 1. 2 eee ween addbib(1) 
roffbib: run off bibliographic database. . . 2... 6 ee we ee eee roffbib(1) 
sortbib: sort. bibliographic database. 2... 6 20 ee ee et es sortbib(1) 
index for a bibliography, find references in a bibliography. indxbib, lookbib: build inverted ....... lookbib(1) 
indxbib, lookbib: build inverted index fora bibliography, find references in a bibliography. ....... lookbib(1) 
from. biff: be notified if mail arrivesand whoitis ......4.. biff(1) 
comsat: biffserver. 2. 0. 0 2 swe ete www e ewe ene es comsat(8C) 
install: install binaries. . 2... 1 2 we ewe wee we we ew ws install(1) 
whereis: locate source, binary, and or manual forprogram. .......-00805 whereis(1) 
find the printable strings in a object, or other binary, file. strings: .......-6.20040e0e. sirings(l) 
uuencode, uudecode: encode/decode a binary file for transmission via mail. se eee ew ew © © ~UUencode(1C) 
' fread, fwrite: buffered binary inpuVoutput . 2... 1... 16 2 ee ee we es fread(3S) 
bind: bind a name to a socket. oe ew lw Swe we cs ew Dand2) 
bind: bind a name to a socket. bo ee we eas! So we: oo s Bind(2) 
binmail: send or receive mail among users. ......2.2. binmail(1) 
bcopy, bcmp, bzero, ffs: bit and byte string operations. . . 2... 21. ww eee bstring(3) 
functions. bit: and, or, xor, not, rshift, Ishift bitwise ......2.2.. bitBF) 
bit: and, or, xor, not, rshift, Ishift bitwise functions. . ..... +2265 es eee ee eee bitGF) 
communication (obsolete). bk: line discipline for machine-machine .......... bk(4) 
sync: update the super block. 2... 2 2 ee ee eee te te we we ete ns sync(8) 
update: periodically update the super block. 2 2 2 1. ee ee ee ee ee te ww wee ws update(8) 
sigblock: block signals, 2... ee eee tee ee wrens sigblock(2) 
sigpause: atomically release blocked signals and waitforinterrupt. ........2.. sigpause(2) 
sum: sum and count blocksinafile, . . 2... 2 ee ee ee we wwe aes sum(1) 
boggle: play the game of boggle. 2. 2 2 6 ee ee eee te te ew we we ws boggle(6) 
boggle: play the game of boggle. 6 2. ew ee ee boggle(6) 
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ching: the book of changes and other cookies. . 2... 2-2 2 2 eee ching(6) 
reboot: UNIX bootstrapping procedures. a ae ee ee ee ee redoot(8) 
mille: play Mille Bournes. 2. 2. 2. 2 2 2 ee ee ee te ee ee te mille(6) 
switch: multi-way command branch... 1.2.2 22 2 ee ee eee ee eevee csh(1) 
login, sh, for, case, if, while, :, ., break, continue, cd, eval, exec, exit, export, 2... 2 6 6 0 e's sh(1) 
break: exit while/foreach loop. .. 2... 2.2. 2+ ee eee csh(1) 
breaksw: exit from switch, . 2. 1 0 1 2 ee ee te we ow cesh(1) 
fg: bring job into foreground. . . 2... 2. 2 2 ee ee - « - csh(1) 
brk, sbrk: change data segment size. 2... 22 ee eee brk(2) 
fread, fwrite: buffered binary input/output .. 2... 2 ee ee eee fread(3S) 
stdio: standard buffered input/output package. ........- . intro(3S) 
stdio: standard buffered input/output package. . 2... 6 2 es ee eee stdio(3S) 
setbuf, setbuffer, setlinebuf: assign bufferingtoa stream. ... 2... 2 2 ee ee eevee setbuf(3S) 
generate a dump of the operating system’s profile buffers. kgmon: . 2... 1. 2s ee ee eee eens kgmon(8) 
sendbug: mail a system bug reportto 4bsd-bugs. 2... 2 6 ee ee et ee sendbug(1) 
bugfiler: file bug reports in folders automatically. ......... . ~ bugfiler(8) 
automatically. bugfiler: file bug reportsinfolders ..... =... =... ~ bugfiler(8) 
references in a bibliography. indxbib, lookbib: build inverted index fora bibliography, find ...... ~~ lookbibd(1) 
spconfig: build spanned disk configuration files. ........ . . spconfig(8) 
mknod: build special file. 2... 6. 2 6 0 ee ee ee we we © © 6 mknOd(8) 
config: build system configuration files. . . 2... 6 2 e+ ee ee - config(8) 
ntohs: convert values between host and network byte order. htonl,htons,ntohl, . . . 2... 2. see ee byteorder(3N) 
bcopy, bemp, bzero, ffs: bit and byte string operations. . . 2. 2. 2 0 ee eee te es bstring(3) 
swab: swap bytes. ...... eS" ei gee Wet gel lal fel 26k Test iw ei ciea Veloso xe swab(3) 
bcopy, bcmp, bzero, ffs: bit and byte string operations. ee we bstring(3) 
co: Coompiler. 2... 2 2 ee ee ee tt we te tt we ec(1) 
cb: C program beautifier, 2. 2 2 2. 6 eee ee ee tes cb(1) 
indent: indent and format C program source. . 2... 2 2 eee ee ee ee we indent(1) 
lint:a C program verifier. 2.0... 2 2 2 ee et ee ee ee lint(1) 
xstr: extract strings from C programs to implement shared strings. ......... xstr(1) 
mkstr: create an error message file by massaging C source. . . 2.2.6 0 2 ee ee ee eee te ewe mkstr(1) 
hypot, cabs: Euclidean distance, see absolute value. . .. 2... hypot(3M) 
cal: printcalendar, . 2... 2. 6 ee ee ee eee we cal(1) 
diskpart: calculate default disk partition SIZE8, wt ttt diskpart(8) 
de: desk calculator, . 2... 0 ee ee ew ee we we we ee ws dce(1) 
cal: print calendar. . . Breer ae TaD dor Je ve Wee OE Sel enim ote! ee fe cal(1) 
calendar: reminder service. Bia es, GP (ee 40 Oe vies Jet re? ae ee calendar(1) 
syscall: indirect sysiem call, ........ aor ee es oa LB, Vet destFelncet oe Weis wrnerrisy ah ie syscall(2) 
gprof: display call graph separa ee ee ee ot ee gprof(1) 
getuid, getgid: get userorgroupIDofthe caller, . 2... 2... 2 ee ee. Sar «e: Stay veh or Oh fe? Cah 8 getuid(3F) 
malloc, free, realloc, calloc, alloca: memory allocator, 1... ee ee ee eee malloc(3) 
siginterrupt: allow signals to interrupt system calls. ..... ee ee ee en ae ae ee ee siginterrupt(3) 
intro: introduction to system calls and error numbers. wi eect, <eUe Ss, Yer Vepes Ter, Sale ye, cen '3 intro(2) 
canfield, cfscores: the solitaire card game canfield, 2... 6. 6 se ee eee wee ee wae canfield(6) 
canfield. canfield, cfscores: the solitairecardgame ......... canfield(6) 
printcap: printer capabilitydatabase. ... 2... 22 ee ee ee eae printcap(5) 
termcap: terminal capabilitydatabase. . . 2... 2 2 2 eee ee eee termcap(S) 
canfield, cfscores: the solitaire card game canfield . 2... 2... 2 ee were eevee canfield(6) 
cribbage: the card game cribbage. . 2... 2. 6 2s eee ee ene cribbage(6) 
cd, eval, exec, exit, export, login, sh, for, case, if, while, :, .,break,continue, .......... sh(1) 
case: selectorinswitch, .. 1... 2 es ee ee eee cesh(1) 
cat: catenate and print. 6 ww we we we ee ee ee cat(1) 
catman: create the catfilesforthe manual, . . . 2.2. 6 1s eee eevee catman(8) 
default: catchall clause in switch, . 2... 6 6 ew eee ee ene esh(1) 
cat: catenateand print 2. 6 1 2 ee ee ee te tt cat(1) 
catman: create the cat files forthe manual. ......... catman(8) 
cb: C program beautifier, 2 0 1 6 2 we ee te ee cb(1) 
chrt, sqrt: cube root, square root. 6 2 1 ww ee sqrt(3M) 
co:Coompiler, 2 22 we ce te tt ee we ee ew ec(1) 
cd: change directory. ......... bes Suet esh(1) 
ed: change working directory, ...... otles vat serate te » « cd(l) 
case, if, while,.: , . , break, continue, cd, eval, exec, exit, export, login, read/ /for, ....... . sh(1) 
round-to-nearest functions. fabs, floor, ceil, rint: absolute value, floor, ceiling, and ..... . =... floor(3M) 
fabs, floor, ceil, rint: absolute value, floor, ceiling, and round-to-nearest functions. ....... . . . floor(3M) 
canfield, cfscores: the solitaire card game canfield. ee ee ee canfield(6) 
chdir: change current working directory, .... 2... 2.200. chdir(2) 
bork, sbrk: change data segment size. 2... 2.2 eee eee ne brk(2) 
chdir: change default directory, . 0. 6... 0 1 0 eee ee eee chdir(3F) 
ed: change directory, 2. 2. 2 6 66 ee ee ew ee we we ww esh(1) 
chdir: change directory. ..... hi cas oi Wey ae Lae ace ign oe Rs tge ht esh(1) 
ioinit: change {77 VO initialization 2... 2... 2. ee wee ioinit(3F) 
chgrp: change group. 2... 6 2 eee ee te ee ee en chgrp(1) 
chmod: changemode. 2... 2-2 ee et ee ewww ens chmod(1) 
chmod: change mode ofafile 2... 6 6 6 ee ee ee ew wwe chmod(3F) 
Ghmod: change mode offile. 6. 6 6 0 eee eee eee es chmod(2) 
umask: change or display file creationmask. ........... esh(1) 
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chown: changeowner. . 2. 22 6 2 ee we ee ew we te ee . chown(8) 
chown: change ownerand groupofafile. .......e-++ee-s chown(2) 
chfn, chsh, passwd: change password file information. . . 2... + s+ 2. passwd(1) 
chroot: change root directory. 2... 2 6 6 2 ee ee ee eee e chroot(2) 
signal: change the actionforasignal. .. . 2... 6 2 es eee signal(3F) 
rename: change the nameofafile, . 2... 2 2 ee ee eee » rename(2) 
set: change value of shell variable. 2... 6 2 ee ee eee csh(1) 
ed: change working directory, ......2-2022 +22 ee cd(1) 
ching: the book of changes and other cookies. 2. 2... 2.2 2 20 es : ching(6) 
better random number generator; routines for changing generators. /srandom, initstate, setstate: . . .. . . random(3) 
pipe: create an interprocess communication channel. ..... . i eign ele ee aw ees: we.  Bipeg) 
ungetc: push character back into input stream. eT ee eae ee - ungetc(3S) 
iscntrl, isascii, toupper, tolower, toascii: character classification macros. fisprint, igh, oe 6 ee © 6Ctype(3) 
eqnchar: special character definitionsforeqn. ..... oo a apn tae is 18 eqnchar(7) 
eqnchar: special character definitionsforeqn. ..... +++. : eqnchar.source(7) 
getc, fgetc: geta characterfromalogicalunit, ... 1... 2 eee eee getc(3F) 
index, rindex, Inbink, len: tell about characterobjects. . 2... 2 0 2 ee ee eee . » + index(3F) 
getc, getchar, fgetc, getw: get characteror word from stream. .....-.- +++ getc(3S) 
putc, putchar, fputc, putw: put characterorwordonastream. ..... «+ 6 6 © © =putc(3S) 
ascii: map of ASCII characterset. 2... 2 ee ee ee ee ee eee - ascii(7) 
putc, fputc: write a charactertoafortraniogicalunit ...... 2+ sees putc(3F) 
tr: translate characters. .....2.2.. ee ae ee tr(1) 
snake, snscore: display chasegame. . . 2... 6 2 ee eee ere er eens snake(6) 
chdir: change current working directory, ....-..+.2e-e chdir(2) 
chdir: change default directory, 2... 2.6 25 es ee ee chdir(G3F) 
chdir: change directory. . 2... 6 2 ee ee et tees esh(1) 
dcheck: file system directory consistency check ..... we, Ser te ie a Oa Oa ae BR er a OS dcheck(8) 
icheck: file system storage consistency check . 2... 6 2 ee eee eee ee te tt we icheck(8) 
fsck: file system consistency check andinteractive repair, . 2. 2. 2 2 ee ee ce ee fack(8) 
quotacheck: check file system quota consistency. .. 2... 2+ ee ee quotacheck(8) 
Checknr: check nroffftroff files. 2... 2 6 6 we ee ee ee we checknr(1) 
eqn, neqn, checkeq: typeset mathematics. 2... 6 ee ee eee eqn(1) 
fastboot, fasthalt: reboot/halt the system without checking the disks. 2. 2... 6.2 0 ee eee ee eee fastboot(8) 
checknr: check nroff/troff a Se et Oise wan ay ee eieees —ele s checknr(1) 
chess: the game of chess. . 2... 0. eee bw ew ee we eww we we we chess(6) 
chess: the gameofchess. 6 2 ww wwe te ee tw chess(6) 
information. chfn, chsh, passwd: change password file ........- passwd(1) 
chgrp: change group. . 2... 6 2 ee ee ee ee we chgrp(1) 
ching: the book of changes and other cookies. ....... ching(6) 
chmod: change mode. 2... 2 eee we ee ee eww chmod(i) 
chmod: change mode ofafile.  . 2... 2... ee ee ee chmod(3F) 
chmod: change mode of file. 2... 1. 2s we we wwe chmod(2) 
chown: change owner. . .. 2... 2. So re eye tice vette a chown(8) 
chown: change owner and group ofafile. ........- chown(2) 
chroot: change root directory. 2... 2. 2 2 ee eee chroot(2) 
chfn, chsh, passwd: change password file information ...... passwd(1) 
closepl:/ plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, ....... plot(3X) 
isascii, toupper, tolower, toascii: character classification macros. /isprint, isgraph, iscntrl, ....... ctype(3) 
default: catchall clause in switch, . 2... 1. 2 ee eee ee ee eens cesh(1) 
uuclean: uucp spool directory clean-up. . 2... 2 2 ee eee wee ee ee ew we uuclean(8C) 
Clear: clearterminal screen. . 2. 2. 2. 2 0 2 ew we we wee clear(1) 
cin: cleari-node. 5.6 6 6 66 6 eee es ee ee wwe clri(8) 
clear: clearterminal screen. . . 2... 2 22 2 ee ee wun clear(1) 
ferror, feof, clearerr, fileno: stream status inquiries. . ......205 ferror(3S) 
csh: a shell (command interpreter) with C-like syntax, 2. 2. 1 1 wee eee ee tt wes csh(1) 
the time to allow synchronization of the system clock. adjtime: correct ........02.0-20+0e000-8 adjtime(2) 
cron: clockdaemon. ....... e+e eee ea ee cron(8) 
Close: delete a descriptor, 2. 2... 2 2 ee ee ee ee close(2) 
shutdown: close down the system at a given HME. we es eR we ee shutdown(8) 
fclose, fflush: close orflushastreaam. . 25... 2.2.0.0 0 020 ee ee fclose(3S) 
opendir, readdir, telldir, seekdir, rewinddir, closedir: directory operations. . . 2... 1... 200 directory(3) 
syslog, openlog, closelog, setlogmask: control systemlog. ....... . . sysiog(3) 
circle, arc, move, cont, point, linemod, space, closepl: graphics interface. /erase,label,line, . . . . . . . plot(3X) 
Clri: cleari-node. 2... 6 1 2 eee wee ew ew ew ww ee ATi(8) 
L. cmds: UUCP remote command permissions file. ...... L.cmds(S) 
cmp: comparetwo files. 2... 2... eee ee eee ee emp(1) 
sccs: front end for SCCS (Source Code Control Subsystem), .......2020e020068-8 secs(1) 
col: filter reverse line feeds.  . 2... 6.6 ee ew eevee col(1) 
colcrt: filter nroff output for CRT previewing, ....... colert(1) 
log. dmesg: collect system diagnostic messagestoformerror ...... dmesg(8) 
colrm: remove columns fromafile ........... colrm(1) 
colrm: remove columns fromafile. . 2... 6 1.2 2 es ee eee colrm(1) 
files. comm: select or reject lines common totwosorted ..... comm(1) 
exec: overlay shell with specified command. . 2... ee ee eee eee ee ene csh(1) 
time: time command. .. 2... 6. 2 2 ee ee ee ew we ewe esh(1) 
routines for returning a stream to a remote command. rcmd, rresvport, ruserok: ae ae a ae ee remd(3) 
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routines for returning a stream to aremote command. rcmd, rresvport, ruserok:; ...... 7 - remdGX) 
rexec: return stream toaremote command. ... 1... 2 eee ee eee : . + rexec(3) 
rexec: return streaamtoaremote command. .......+.2-see-6 oe - rexec(3X) 
system: issue ashell command. ....... Re ei. sin eral Seo ne: Biwi Sieh ee we system(3) 
system: executea UNIX command. . 2.2.2 6 ee ee ee ee ee te et ts system(3F) 
_ ‘test: condition command. ......-2.4. Ba at Sle, <6 ea aie Se test(1) 
time: timea command. ..... 2.2 ee ee inate ive SO aP ew time(1) 
nice, nohup: run a command at low priority (s h sas Pee ee ee ae nice(1) 
switch: multi-way command branch. 6 8 ae eae . - » csh(1) 
uux: unix tounix commandexecution, . . 2... 22 ee ee eee eee wux(1C) 
rehash: recompute commandhashtable. .. 2... 2... 5+ ee ee eee . esh(l) 
unhash: discard commandhashtable. .. 2... 2.2.2. se ee . - csh(1) 
hashstat: print command hashing statistics,  . 2. 2... 2 eee ee eee esh(1) 
nohup: run command immune tohangups. .......-+-++e-s esh(1) 
csh: a shell (command interpreter) with C-like syntax. ......-+.-. esh(1) 
whatis: describe what a command is. OSS iaS as tes we eran et excel, See eb we whatis(1) 
readonly, set, shift, times, trap, umask, wait: command language. /exec, exit, export, login, read, ... . . sh(1) 
getarg, iangc: retum commandline arguments. ........-6-+ +--+. getarg(3F) 
L.cmds: UUCP remote command permissions file. . .....+ 6. - » Loemds(5) 
repeat: execute command repeatedly, . 2... 1 2 ee eee ee ee © CBHI) 
, rc: command script for auto-reboot and daemons. ....... re(8) 
onintr: process interrupts in command scripts. 2. 2. 6 2 ee ee ee ee ee ees esh(1) 
apply: apply a command to a set of arguments. .. . aC ee ee apply(1) 
goto: commandtransfer, . 2... 6 2 1 wee ee we ee tw csh(1) 
else: alternative commands. . . 2... 2.2 eee eee eee eee ene csh(1) 
intro: introduction to commands. .... . WB See We lela eh ear ven ar Men ie lcs intro(1) 
introduction to system maintenance and Operation commands. intro: . 2... 6 1 1 eee ee ee ee intro(8) 
at: execute commandsatalatertime. . 2... 2... 2 ee eee eee at(1) 
apropos: locate commands by keywordlookup. ..... +. ese eee apropos(1) 
while: repeat commands conditionally, 2. 2... 2 2 ee ee ee ene csh(1) 
lastcomm: show last commands executed in reverse order. . 2... 2... 5 oe lastcomm(1) 
source: read commands fromfile. ... 2... 6 ee ee eee eee csh(1) 
comm: select or reject lines common to two sorted files. Gog, See wS TS nate" Net ai fal cre comm(1) 
socket: create an endpoint for communication. ......... SS! cat fens. ath eh eats socket(2) 
ipe: create an interprocess communicationchannel. .. . 2... 2 6 2 ee ee eee pipe(2) 
bk: line discipline for machine-machine communication (obsolete). . 2... 2 1 6 ee ee ee we bk(4) 
talkd: remote user communication server, . . 6. 6 0 se ee ee see talkd(8C) 
dh: DH-11/DM-11 communications multiplexer, . 2... 6 2 ee ee eee dh(4) 
dl: DL-11_ communications multiplexer, 2... 0 2 2 ee ee ee ee dl(4) 
dz: DZ-11 communications multiplexer. . 2... 2 2 ee ee ee dz(4) 
cp: Intelligent Communications Processor. 2 2 ww 6 ee ee ee ee cp(4i) 
users: compact list of users who are on the system. ........ users(1) 
diff: differential file and directory comparator, . . 2. 2. 22 eee we ee ee ew ws diff(1) 
cmp: comparetwofiles. ©... 2-6 ee ee ee ee ees cmp(1) 
diff3: 3-way differential file comparison. . . 2. 2. 2 ee ee ee ww ew wee we diff3(1) 
intro: introduction to compatibility library functions. Cee ele ee Ser ee ee intro(3C) 
liszt: compile a Franz Lisp program. .... 2.2.2.2. ee ee liszt(1) 
ec:C compiler. .......224-2.2-. gee res bese eae Ghee 2 cec(1) 
{77: Fortran 77 <compiler,. . 6-654 ee Swe ae ee ee OS £77(1) 
pe: Pascal compiler, . 2. 2 2 2 6 ee ee ee ee we ew ww ws pe(1) 
error: analyze and disperse compiler error messages. ee a ee ee ae ae er eee ee error(1) 
yacc: yetanother compiler-compiler, . 2... 2... 2 2 ee eee eee yacc(1) 
wait: wait for background processesto complete. . . 2... 2 2 6 eee eee ee ewe ee esh(1) 
wait: await completion OF PYOCOSS., ane Se We we eS ww eS wait(1) 
hypot, cabs: Euclidean distance, complex absolute value. 2... 2... 2 2s ee ee ween hypot(3M) 
compress, uncompress, zcat: compressand expand data. . .. 2... 2 ee ee eee compress(1) 
data. compress, uncompress, zcat: compress and expand ec er oe se compress(1) 
lear: computer aided instruction about UNIX. ......... learn(1) 
hangman: Computer version of the game hangman. .......2.. hangman(6) 
comsat: biffserver, 2... 2 0 ee wee we et te comsat(8C) 
test: conditioncommand. ... 2... 2. 6s eee ec eee test(1) 
endif: terminate conditional. . ... 1... 2 ee ee eee eA cere: ons wa cesh(1) 
if: conditional statement. . . 2... 6. ee ee we . esh(1) 
while: repeat commands conditionally, .. 2... 8 2 ee eee ee eee esh(1) 
config: build system configuration files. . . . ene config(8) 
gettytab: terminal configuration database. 2... 2... 1... 22 eee ene gettytab(5) 
resolver~ resolver configuration file. . 2... 2... 2.2 eee eevee resolver(5) 
config: build system configuration files. 2. 2... 6. 1 ee ee ewe ew ene config(8) 
spconfig: build spanned disk configurationfiles. . 2... 2... 2. eee eevee speonfig(8) 
ifconfig: configure network interface parameters. .. 2... ...4.. ifconfig(8C) 
. connect: initiate a connection ona socket. . ........- connect(2) 
tip, cu: connect toa remote sysilem. 6 ww 1 we ee ee ee tip(1C) 
getpeername: get name of connected peer. . 2 6 2 2 eee wee we ee te getpeername(2) 
socketpair: create a pairof connected sockets. 2. 2... 2 2 ee ee ee we wwe we socket pair(2) 
shutdown: shut down part of a full-duplex connection, . 2... 6 6s eee eee eee ee ee shutdown(2) 
accept: accepta connectiononasocket. 2.2... 2... ee ee ees accept(2) . 
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connect: initiate a connectiononasocket. 2... 1 2 ee we ee te ews connect(2) 
listen: listen for connections ona socket. . 2. 6 6 6 0 ee ee ee we ww listen(2) 
quotacheck: check file system quota consistency. és Soma ete Br ge ata TaN a ee Btw quotacheck(8) 
dcheck: file system directory oonsistencycheck. . . 2.1 2 ee eee eee eee ne dcheck(8) 
icheck: file system storage consistency check. 2... 2 2 2 eee eee re eee icheck(8) 
feck: file system consistency check and interactive repair. . .... +... fsck(8) 
show what versions of object modules were used to constructa file. what: 2... 2 0 6 2 ee eee ew ee what(1) 
mkfs: constructafilesysiem. .. 2... 2. ee eee ee ewe mkfs(8) 
newfs: constructanewfile system. .. 2... 5. 2 ee eee oe newfs(8) 
mkproto: construct a prototype file system. 2 2 1 2 2 2 2 ee ee mkproto(8) 
deroff: remove nroff, troff, tbl and eqn constructs. .. . eile to t6i Ae fein Se wie) Be @ ie kei LS deroff(1) 
setriimit: control maximum system resource consumption. getrlimit, ...... Gn 6s ete! Gere) Oe getriimit(2) 
vlimit: control maximum system resource consumption. .. 2... eee eee eee ee ewe vlimit(3C) 
/openpl, erase, label, line, circle, arc, move, cont, point, linemod, space, seas graphics) ...... . plot(3X) 
badsect: create files to contain bad sectors. . 2... 6 6 2 2 ee eo ee ee wee badsect(8) 
Is: list contents of directory. 2... 2.2 2 ee ee ee ees Is(1) 
sigstack: set and/or get signal stack context. i ee oe en a Oa ne rs, 
sh, for, case, if, while, :, ., break, continue, cd, eval, exec, exit, export, login/ ...... .. sh(1) 
continue: cycle inloop. . . 2... 6 6 ee ee ee ee + CBh(l) 
arp: address resolution display and control. .. 2... 2 ee eee eee ee eo ew oe wo + MMBC) 
fentl: file contro ..... bi, eres 68 ot Aes ded “esis Dae for Sn - + fentl(2) 
ioctl: control device. 2... 6 1 ew ew ee tw te ee ete joctl(2) 
init: process control initialization. . . aes ws Welle er: ae ts init(8) 
getriimit, setrlimit: contro! maximum system resource consumption. ae te aoe eT getriimit(2) 
vlimit: control maximum system resource consumption. ...... viimit(3C) 
Ipc: line printer control program. ....... eee ae. Seo ene abe Ipe(8) 
timedc: timed control program. ....... lac rnd for, sey piste Tee ay, ty Mae fe timedc(8) 
tcp: Internet Transmission Control Protocol. . .... 2... > ee tep(4P) 
sccs: front end for SCCS (Source Code Control Subsystem). os aa net Jer ca tai, labore sore sccs(1) 
syslog, openlog, closelog, setlogmask: control sysiemlog. . . 2. 2. 6 ee ee ee ee woe sysiog(3) 
vhangup: virtually ‘‘hangup’’ the current controlterminal. . 2... 2 2 0 eee eee ee ewe vhangup(2) 
ex: Excelan 10 Mb/s Ethernet controlier. . 2... 2 1 ee ee eee ewe we wee ae ex(4) 
il: Interlan 10 Mb/s Ethernet controller, . . 2... 2 se ees Be os bute eal octet ee, il(4) 
nw: Integrated Solutions, Inc., 10 Mb/s Ethernet controller, . 2... 6 0s ee eee ewe ee we ne nw(4i) 
term: conventional names forterminals. . . . 2... 5 se eee term(7) 
ecvt, fcvt, gcvt: oulput conversion, . . 2... 6 2 ee ee ee te ew te te ts ecvt(3) 
long, short: integer object conversion. . 2... 6 2 se eee ee we tw ee ww long(3F) 
printf, fprintf, sprintf: formatted output conversion. . 2.2. 6 2 eee ee ete ee tt ee printf(3S) 
scanf, fscanf, sscanf: formatted input conversion. . . . 2... 6 eee ee ee te ee ew seanf(3S) 
units: conversion program. . . 2... 2. 2 ee eee ee ews units(1) 
ns_addr, ns_ntoa: Xerox NS(tm) address conversion routines. 2... 2. 6 se se ee ee eee ns(3N) 
dd: convertand copyafile. 2... 2... 2. 2 eee ee wee dd(1) 
number: convert Arabic numeralstoEnglish ........2.2.2-. number(6) 
ranlib: convert archives to random libraries. . 2. 2... 1 ee ees ranlib(1) 
atof, atoi, atol: convert ASCII tomumbers. . 2... 2 0 ee ee te ee atof(3) 
Ctime, localtime, gmtime, asctime, timezone, tzset: convert date and time to ASCII. .......2-22e6- ctime(3) 
htable: convert NIC standard format hosttables. . ......46-. htable(8) 
bed: convertto antique media. . 2... 2 we ee ewe bed(6) 
htonl, htons, ntohl, ntohs: convert values between host and network byte order, .. .. byteorder(3N) 
ching: the book of changes and other cookies. 2... 1 1 ee eee eee eee we eee ching(6) 
Cp: COpy. 2 ee eee eer eee eee ree ese eve cp(1) 
rep: remote file copy, 2... 6 se ee eee ee te we we ww rep(1C) 
uucp: unix toumix COpy. . 2. 2. 6 ee eee ee we ew we were evens wucp(1C) 
dd: convertand copyafile. 2... 6 ee ww ee ee ee ew we ee dd(1) 
lcopy: copyamagtape. .. 1... 22 2 eee eee ee eee teopy(1) 
fork: create a copy of this process. .. . Bo aie hee ete. ase ee fork(3F) 
remainder, exponent manipulations. copysign, drem, finite, logb, scalb: ‘copysign, eo 0 eo eo oo =fe0e(3M) 
copysign, drem, finite, logb, scalb: copysign, remainder, si a ae Saeae oe ee oe «feee(3M) 
plock: lock the current processin core. 2... 6 2 ee eee wee eee e Se eo oe ae plock(2) 
savecore: save a core dump of the operating ‘system. ee ee . . s ~ =savecore(8) 
core: format of memory image file. at restOiciet fer Os Hes esas on core(S) 
gcore: get core images of running processes. . ......... =. . geore(l) 
system clock. adjtime: correct the time to allow synchronization of the . .... . . adjtime(2) 
functions and their inverses. sin, cos, tan, asin, acos, atan, atan2: trigonometric ..... . . sin(3M) 
sinh, = tanh: hyperbolic functions. eh bb ediciee ries tea) ce he Mee sinh(3M) 
we: word Soe Wer ter setae Gat sé; ie? cac\iee Ae" ver Gee tw? oeah voice we(1) 
sum: sum and cia bios ta slic é aisatte ene 8 erie eM Ventanas sum(1) 
+) ee ae eee ae a cp(1) 
cp: Intelligent Communications Processor, ......6. cp(4i) 
crash: what happens when the systemcrashes. ....... crash(8V) 
crash: what happens when the sysiem crashes. . . 2. 22 2 0 0 eee ese eee een ae crash(8V) 
creat: createamewfile, 2. 2. 2. 2 1 2 ee ee we we ew creat(2) 
fork: create acopy ofthis process. ..... Be ye, ee ete fork(3F) 
creat: createanewfile, . 2. 2 6 2 ee we ww te we ew ew creat(2) 
open: open a file for reading or writing, or createanewfile, 2... 2. 2 ee ew ew ee . open(2) 
fork: create anew process. 2. 6. 6 ee ee ee ee ee ew ws fork(2) 
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socketpair: create a pair of connected sockets. 2. 2... 2 2 2 ee eee socket pair(2) 
- Ctags: createatagsfile, 2. 6 6 2 ee ew we we ee ew ee ctags(1) 
socket: create an endpoint forcommunication. .......-+- >. socket(2) 
mkstr: create an error message file by massaging C source. ..... mkstr(1) 
pipe: create an interprocess communication channel. . . ....- - pipe(2) 
badsect: create files to contain bad sectors. 3... 2 1 1 2 ee ee badsect(8) 
addbib: create or extend bibliographic database. . . 2... 2-5 es addbib(1) 
catman: create the cat filesforthe manual. ........-2066-. catman(8) 
umask: change or display file creation mask. . . 2... 2 2 2 ee ee eee ee eee esh(1) 
umask: set file creationmode mask, .........-. at eens + umask(2) 
cribbage: the card game cribbage. . .....5...-. eee ee ee ae . - cribbage(6) 
cribbage: the card game cribbage. Ce Roe A law, eos cribbage(6) 
cron: clock daemon. ww ww ew eee we tn eo ee « efon(s) 
Ixref: lisp cross reference program. ......2... Sie e Wiha nter te: Ixref(1) 
pxref: Pascal ene en 6 ky ae We eta ee Aa See te He pxref(1) 
systat: display system statisticsona cit. .. 2.4... es eee eae see eo ew we oe  «BYStat(l) 
colcrt: filter nroff output for CRT previewing. cee ee ee eww we eww ow ow oo COler(]) 
more, page: file perusal filterfor crt viewing, . 2... 62 6 ee ee eee ee oe ee ee 6m!) 
crypt: encode/decode. . 2 6 6 6 ee ee ee we eo oe © Coypt(l) 
ctypt, setkey, encrypt: DES encryption. ..... + + + Crypt(3) 
syntax. csh: a shell (command interpreter) with C-like ....... esh(1) 
Ctags: create atagsfile, 0... 1. 2 ee ee ew te ee es ctags(1) 
convert date and time to ASCII. ctime, localtime, gmtime, asctime, timezone, tzset: .... . ctime(3) 
time, ctime, Itime, gmtime: retum systemtime. ........-. time(3F) 
tip, cu: connect to a remote system. 2 6 6 1 ee ee tte tip(1C) 
cbrt, sqrt: cube root, square root. 2 2 6 6 we we ee ee tt es sqrt(3M) 
vhangup: virtually ‘‘hangup’’ the current controlterminal. . 2... .....-2-005000- vhangup(2) 
domainname: set or display name of current domain system. .... 2... 2 eee se eee domainname(1) 
gethostid, sethostid: get/set unique identifier of currenthost. ....... Oe aT aie ee ee ee gethostid(2) 
gethostname, sethostname: get/set name of currenthost. ........ : BU ia Wi alakzartecty en %6 gethostname(2) 
hostnm: get name of currenthost. . 2... 2 0 ee ew ee wwe eww es hostnm(3F) 
hostid: set or print identifier of current host system. és oe Sisal wis hostid(1) 
hostname: set or print name of current host system. a oe a Scare © hostname(1) 
jobs: print currentjoblist. 2... 6 6 1 ww ee ee ee ew ew esh(1) 
punlock: unlock the current process. 6 6 6 6 we ee ee ee ee th we es punlock(2) 
highpri: make the current process a high priority process. . 2... 0... highpri(2) 
normalpri: make the current process a normal priority process. . .......-. normal pri(2) 
plock: lock the current processincore, 2... 6 6 ee ee ee ee eee plock(2) 
sigsetmask: set currentsignal mask. .......2.4-2e-. ec hil ea. Yes sigsetmask(2) 
whoami: print effective currentuserid. . 1... 0 2 se ee ee eee ewes whoami(1) 
chdir: change current working directory, . . 2... 21. 1 ee ee uae chdir(2) 
getcwd: get pathname of current working directory, . 2... 2.2 ee ee eee getcwd(3F) 
getwd: get current working directory pathname. ..........5 getwd(3) 
motion. curses: screen functions with ‘‘optimal’’ cursor... . . . « curses(3X) 
curses: screen functions with ‘‘optimal’’ cursormotion. ......... age Bh etae Si Pat Se onae a) ie curses(3X) 
spline: interpolate smooth curve. ...... et ee ee ee ae es ae ae ee spline(1G) 
continue: cycleinloop. . 2... 6 6 6 ee ee ew ee ww we cesh(1) 
cron: clock daemon. ..... 2622-2 ee ee Sere Slane. % cron(8) 
Ipd: line printer daemon. ...... aie. ac ee fe eee ees Sale Ge Ipd(8) 
routed: network routing daemon. ....... hs en fay tos cia! Mae Gee cet Sir oko ce ow 0 routed(8C) 
timed: time server daemon. .. 2... 2 ee ee eee erence reeves timed(8) 
XNSrouted: NS ‘biting Information Protocol daemon. . ee ee eee a Sh es ag XNSrouted(8C) 
rc: command script for auto-rebootand daemons. . . . 2.2. 2. 2 eee eee ees twee re(8) 
ftpd: DARPA Internet File Transfer Protocol weaver: eo eras er eS ftpd(8C) 
whois: DARPA Intermet user name directory service. ..... . . whois(1) 
telnetd: DARPA TELNET DBOTV OE ere oo 8 telnetd(8C) 
DARPA Trivial File Transfer Protocol server. ....2.4.. tftpd(8C) 
compress, uncompress, Zcat: compress and expend Cot a a a ae ee ar er . pase S, ew Se See compress(1) 
eval: re-evaluate shell data. 2... 6 6 2 ee we ewe we wt ww wee wwe esh(1) 
gprof: display call graph profile data. .......... Se ee a ee eee er gprof(1) 
prof: display profile data. . 2... 2 ee ee wee we ew eee ee nee prof(1) 
ttys: terminal initialization data. . . 2... 2 2 eee eee ve eese ttys(5) 
gettytab: terminal configuration database. . 2... . 1... 2. ee eevee se ee + gettytab(5) 
hosts: host mame database. 2... 6 6 0 eee ee ee ee . hosts(5) 
networks: network name database. 2... 2 2 2 2 ee ee eee ee we te wes networks(5) 
phones: remote host phone number database. . 2... 2 2 2 ee et eee et et we phones(5) 
printcap: printer capability database. . ...... Rig otal are Caled, oat 1d hs ae Sie printcap(S) 
protocols: protocol name database. 2... 2. 2 ee eee ee we eee ewe ew protocols(5) 
services: service name database. . . 1... ee ee te we ee we wt tw es services(5) 
termcap: terminal capability database. . ... 1... eee ee ee eee ee termcap(5) 
vgrindefs: vgrind’s language definition database. . . 2. 2. 2 0 2 2 2 ee ee ee ww ewes vgrindefs(5) 
newaliases: rebuild the data base for the mail aliasesfile. . ......5.. 2008-6 newaliases(1) 
dbminit, fetch, store, delete, firstkey, nextkey: database subroutines. . 2... 0 1 2 ee ee eee . dbm(3X) 
dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr: data base subroutines. /dbm_store,dbm_delete, . ..... ndbm(3) 
brk, sbrk: change datasegment size. . 2. 2... 6 ee eee ee ve eee brk(2) 
mull: datasink. . . 1... ee ee ee ee we ee ww tw tw null(4) 
July 1987 -XX- INTEGRATED SOLUTIONS 4.3 BSD 


types: primitive system datatypes. .......-2.06- . ar ae ae ae de types(5) 
addbib: create or extend bibliographic database. ......2.. oS gi. as Seg Cetera ee eS addbib(1) 
roffbib: run off bibliographic database. ...... Sue af odo Sie ae: SR et seyae Tae roffbib(1) 
sortbib: sort bibliographic database. . 2. 2... 2. ee ee ee te ee ee ee sortbib(1) 
keys. map3270: database for mapping ascii keystrokes into IBM 3270 . map3270(5) 
join: relational database operator, 2... 2 2 eee ee ee ew wns join(1) 
date: printand setthe date. ......... : Ct eh By RLS pe date(1) 
gettimeofday, settimeofday: get/set dateandtime. . . 2... 2... eee eee eevee gettimeofday(2) 
time, ftime: get dateandtime. 2... 6... 2 ee ee ee ee reese time(3C) 
fdate: return date and time in an ASCII string. ee ee ee ee ee fdate(3F) 
gintime, asctime, timezone, tzset: convert date and time to ASCII. ctime, localtime, .......-.. ctime(3) 
touch: update date last modified ofafile. 2... 6 ee eee we wees touch(1) 
idate, itime: return date ortime in numericalform. ...... 2+ + «ese idate(3F) 
date: print and set the date. ee ee ee ee ee ae date(1) 
dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr: data base subroutines. /dbm _store, ae a ee ndbm(3) 
dbm firstkey, dbm_nextkey, dbm_error,/ dbm | | open, dbm_close, dbm_fetch, dbm_store, dbm_: delete, ...... ndbm(3) 
dbm_open, ébm | Close, dbm _ fetch, dbm_ store, dbm_delete, dbm_ | firstkey, dbm_ nextkey, dbm_error, . - Bdbm(3) 
/dbm_store, , dbm ._ delete, dbm _firstkey, dbm _nextkey, dbm_etror, dbm_clearerr: data base subroutines. . . .. . . ndbm(3) 
dbm _ nextkey, ¢ dbm_error, dbm_open, dbm_close, dbm_fetch, dbm | | store, dbm_delete, dbm _firstkey, .. . . . ndbdm(3) 
data/ /dbm_close, dbm_ | fetch, dbm_store, dbm_ “delete, dbm | firstkey, dbm _ nextkey, dbm_error,dbm_clearerr: . . . . ndbm(3) 
data base subroutines. dbminit, fetch, store, delete, firstkey, nextkey: ..... . . dbm(3X) 
/dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error,dbm_clearerr: database/. . . . . . ndbm(3) 
dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error,/ dbm_open, dbm_close, dbm_fetch,dbm_ store, ...... - ndbm(3) 
dbm_error/ dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey,dbm_nextkey, . . . . ndbm(3) 
dbx: dbx symbol table information. .....+ 2+ see dbx(5) 
dbx: debugger. .....-.. betec lie. Kaz teres Gy 0a, aN . dbx(1) 
dbx: dbx symbol table information, .... 2. 2 2 ee ee ee dbx(5) 
de: desk calculator. ...... ee a ae ee ee dc(1) 
dcheck: file system directory consistency check. oe «© « 6 + Gcheck(8) 
dd: convertand copyafile. . 2... 2 ee ee eee ee dd(1) 
adb: debugger. . 2... 6 we we eee ew et we we we wens adb(1) 
dbx: debugger. . 0 6 cee eee dbx(1) 
rx: DEC RX02 floppy disk interface. . . 2... 2.2 ee eee rm(4) 
bad144: read/write dec standard 144 bad sector information. ....4....- bad144(8) 
od: file dump (octal, decimal, hex, ascii). 2. 2. 2 6 2 ee ee ee et te es od(1) 
tp: DEC/mag tape formats. 2... 01 1 2 ee ee eee ws tp) 
default: catchall clause inswitchh . 2... 2.2. eee ee cesh(1) 
chdir: change default directory, ........2.-. ah 8) Cebwias weir we? oe chdir(3F) 
diskpart: calculate default disk partition sizes. Sie ee Ge bre Bay oe a Ser ey diskpart(8) 
vgrindefs: vgrind’s language definition database. . 2... 1. 2 2 ee eee eves vgrindefs(5) 
eqnchar: special character definitions foreqn. . 2... 2 2 2 ee ee ee ee ee eqnchar(7) 
eqnchar: special character definitionsforeqn. . .. 2... + see eee ee eee eqnchar.source(7) 
stty, gtty: set and get terminal state (defunct). . . 2. 2. 2 2 2 ee ee ee te we te ee ewe stty(3C) 
close: delete adescriptor, . 2. 2 2 2 1 ee we ew ew er te ww close(2) 
dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines. ote 4e> fam eee dbm(3X) 
tail: deliver the last partofafile. .. 2... 1.2.2.2 se wee tail(1) 
mesg: permit or deny messages. 9. 2 2. 2 ee ee ee ee ee eee mese(1) 
tset: terminal dependent initialization. 2... 1... 2 2 ee eee ewe tset(1) 
constructs. deroff: remove nroff, troff, viene o! al ia) veil tet conve? Jes deroff(1) 
crypt, setkey, encrypt: DESencryption. .. 2.2... 2. 2 ee wee er eee ne crypt(3) 
whatis: describe whatacommandis. ....... ee ee eee whatis(1) 
mailaddr: mail addressing description, . . 2. 2 eee ee ee ee we wees mailaddr(7) 
getdiskbyname: get disk description by itsname. . . . . - 6 2 ee ee ee eee getdisk(3X) 
getdiskbyname: get disk description by itsname. . .. 2... 2 21 se eevee getdiskbyname(3) 
disktab: disk descriptionfile. . 2... 2. 22 eee eee ewe eee disktab(5) 
L-devices: UUCP device descriptionfile. 2... 6 2 ee ee ew eee eee L-devices(5) 
L.sys: UUCP remote host description file. . 2... 2 2 ee ee eee ewe ene L.sys(5) 
remote: remote host description file. Re ere ag fe 6. ee eee ASS remote(5) 
close: deletea descriptor, . 2... 2. 2 wwe ew ee ew ew eee close(2) 
“dup, dup2": duplicate a descri BGs os tes Fa oe eee) ee ae dup(2) 
getfstype, setfsent, endfsent: get file system descriptor file entry. Igetfespec, getfsfile, . S35 we THER getfsent(3) 
getfstype, setfsent, endfsent: get filesystem descriptor file entry. /getfsspec, getfsfile, ...... getfsent(3X) 
getdtablesize: get descriptortable size. . 2... 2-2 2 se we ee ws getdtablesize(2) 
dc: deskcalculator, . 2... 2s we ee wen e ee ce oe © OI) 
access: determine accessibility of 2 file. bebe wi Syed access(3F) 
access: determine accessibility of fille. . 2... 2... 2 se ewes access(2) 
file: determine filetype. .. 2... 2. 2s eee re ae eo file(1) 
drum: paging device. . 2... se ee eee eee * os drum(4) 
fold: fold long lines for finite width output device. 2... 6. 2 6 eee ee te ee ew ew eee fold(1) 
sOctiS control “OVICE: (scsi See a ees SE Shee a Se AEs ioctl(2) 
L-devices: UUCP device description file. ....+ 2.2.2.2 2.2 L-devices(5) 
swapon: adda swap device for interleaved paging/swapping. .. .... 1. 2s swapon(2) 
swapon: specify additional device for paging and swapping. .....- 2... ee ee swapon(8) 
Of: disk free. 6 sc we tw te we ts oe ae” me ee df(1) 
fimin, fimax, ffrac, dfimin, dfimax, dffrac, inmax: return extreme values. . 2... 2.2... fimin(3F) 
fimin, fimax, ffrac, dflmin, dfimax, dffrac, inmax: retum extreme values. . . 2.2.2.2. fimin(3F) 
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values. fimin, fimax, ffrac, dfimin, dfimax, dffrac,inmax: retumextreme ....... fimin(3F) 
dh: DH-11/DM-11 communications multiplexer. . ..... dh(4) 
dh: DH-11/DM-11 communications multiplexer. . ....... dh(4) 
dmesg: collect system diagnostic messages toformerrorlog. .....-+-+.e. dmesg(8) 
explain: print wordy sentences; thesaurus for diction. diction, . 2... 2 6 se see eee eee ee diction(1) 
for diction. diction, explain: print wordy sentences; thesaurus ...... diction(1) 
diff: differential file and directory comparator. .. ++. +. diff(1) 
diff3: 3-way differential file comparison. .....-..4- diff3(1) 
diff: differential file and directory are tara er eee ee diff(1) 
diff3: 3-way differential filecomparison. .. 2... 2.2. 2 eee eee diff3(1) 
dir: format of directories. . . 2.2. 65s see eee » « dir(5) 
dir: formatof directories; . 2... 6 1s eee ee ewe ew we wwe dir(5) 
rm, rmdir: remove (unlink) files or directories. . 2... 6 2 se ee eee ee ae ee rm(1) 
rmdir: remove (unlink) directories. a I Bie el ae bee ee ee ae ee rmdir(1) 
sticky: persistent text and append-only directories. ..... 2... 26 a ee eee ee sticky(8) 
cd: change working directory. ic oe» oe. Te: Serpe fe, Se see os ee setae at Ses fee cd(1) 
chdir: change current working directory, ..... 2.2. eee oo ale acai? es chdir(2) 
chdir: change default directory, ..... boxe ee S. Ser we ets daicbie fey doe8e fe chdir(3F) 
chroot: change root directory, 2. 2.6 2 ee ee eee te ee ee ewes chroot(2) 
cd: change directory, .. 1... 2.2 ee Sua Boras a Tee enters csh(1) 
Chdir: change directory, 2... 2 2 0 ee eee ee ee we we te ee cesh(1) 
getcwd: get pathname of current working directory, . 2... 6 2 2 2 eee we te ew te ees getcwd(3F) 
Is: list contents of directory. .........2-. Se Herel ee tek Sele Sek Jee dae Is(1) 
mkdir: make a directory. ....... wo Go ends Bete: ah Be ee mkdir(1) 
scandir, alphasort: scana directory. . . 2. 1. 2 2 ee ew te ee we we ee eww scandir(3) 
uuclean: uucp spool directoryclean-up. . 2... 2. ee eee eee ee ees wuclean(8C) 
diff: differential file and directory comparator. Si t6), oi foie Cercleicval ese e ven toe bx ce diff(1) 
dcheck: file system directory consistency check, . . 2... 2 2 eee eevee dcheck(8) 
unlink: remove directoryentry, ..... ee a ae ee ae ee ee unlink(2) . 
unlink: remove a directoryentry, 2... 1. 2 ee eee ee ee eens unlink(3F) 
mkdir: make a directoryfile. 2... 2. 1 ww ee ee eee eens mkdir(2) 
- wmdir: remove a directory file. . 2... 1... ee eee ee ee eee rmdir(2) 
mklost+found: make a lost+found. directory for fsck. OS hee fe ee een Setar 05S 1S ers mklost+found(8) 
pwd: working directoryname. . 2. 2... 2. 2 2 eee ee ewe ww pwd(1) 
readdir, telldir, seekdir, rewinddir, closedir: directory operations. opendir, . . . 2... 6. ee eee directory(3) 
getwd: get current working directory pathname. . . . 2. 2.2 6 ee ee ee ees getwd(3) 
whois: DARPA Internet user name directory service. Bee Sees See a te. Be es whois(1) 
popd: pop shell directory stack. SS Br ae ie ete], te a? Bm ge. csh(1) 
pushd: push shell directory stack  . 2... 1 0 eee eee eens . csh(1) 
unhash: discard commandhashtable. ...... ee ee ~ 6CSh(1) 
unset: discard shell variables. 2... 2... 2 ee ee ee ee ee csh(1) 
(obsolete). bk: line discipline for machine-machine communication oe eo ee «KA 
synchronize a file’s in-core state with thaton disk. fsync: 2... 6. 6 ee eee ee ee we we ns fsync(2) 
hk: RK6-11/RK06 and RKO7 moving head disk. . 2... 1 ee ee ee ee ee ewe . . hk(4) 
rk: RK6-11/RK06 and RKO7 moving head disk. ..... 2, Gu eee ae eet ad . . mk(4) 
sd: VME SCSI disk adaptor interface. oe reise: tan os Be lore na acteinies <b ss sd(4) 
spconfig: build spanned disk configuration files. 2... 2... 2... 2 ew ee eee spconfig(8) 
getdiskbyname: get disk description by itsname. . 2... 2... 1 ee eee getdisk(3X) 
getdiskbyname: get disk description by itsname. .........60080 getdiskbyname(3) 
disktab: disk description file, . 2... 2. 6 ee eevee eevee disktab(5) 
sp: disk spanning pseudo diskdriver, 2. 2. 2 2 ee eee eee eee ee eee sp(4i) 
OS) Gisk 1066. 5 eee cee ar ey ae oe Sw df(1) 
el: diskinterface. 2... 11 1 ewe eee eee ere ew ee el(4) 
hp: diskinterface. 2... 1. 2 2 ee ee ee ee we wees hp(4) 
tx: DEC RX02 floppy diskinterface. 2... 1 1. 1 we we ee www te ws 1x(4) 
sm: VME SMD disk interface. ......... cise aaa abi, Se oes Fe sm(4) - 
diskpart: calculate default disk partition sizes. 2 2 2. 2 2 ee ee ee ewer ewe diskpart(8) 
quota: manipulate disk quotas. ..... ae ee ee es ae ee ee quota(2) 
sp: disk spanning pseudo disk driver. | ee ee ee a ee sp(4i) 
driest: standalone disk test program. . . 2... 6 ee we eee te eee drtest(8) 
du: summarize diskusage. . 2... 2. 2 se ee er ween veers du(1) 
quota: display disk usage andlimits. 2... 6 1 eee eee evens quota(1) 
diskpart: calculate default disk partition sizes. .....4.. diskpart(8) 
reboot/halt the system without checking the disks. fastboot,fasthalt: ..... se: dove Sak GE ees fastboot(8) 
rxformat: format floppy disks. ......- 2.20222 Ua ae we a en eras aos rxformat(8V) 
disktab: disk description file. ...........2..4. sktab(5) 
mount, umount: mount and dismount filesystems. . 2... 2 ewe eee eee nes mount(8) 
error: analyze and disperse compiler error messages. 2... 0 2 1 ee ees error(1) 
rain: animated raindrops display. ......... sae Dae cies wal Sol as he Mee ae rain(6) 
arp: address resolution displayandcontrol. .. 2.2... 56 ee ee ee eee arp(8C) 
gprof: display call graph profile data, ..........06 gprof(1) 
snake, snscore: display chase game. . 2 2... ee ee ee ee snake(6) 
quota: display disk usage and limits. . . Goleta erg, we. Buea & quota(1) 
vi: screen oriented (visual) display editorbasedonex. . .. 1... 2. 2.2. s ee eee vi(l) 
umask: change or display file creation mask. ......... tas See esh(1 
domainname: set or display name of current domain system. . ......2.2.. domainname(1) 
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prof: display profiledata. . ....... Se a ee eae ee prof(1) 
systat: display system stalisticsonactt .......-6--. - + « systat(1) 
sysline: display system status on status line ofaterminal. ..... . sysline(1) 
worms: animate wormsona displayterminal. .. 2... 2... 2 eee aa - ‘worms(6) 
wulog: display UUCP log files. . 2 2 2. 6 2 ee ee ow oo oe © Ulog(IC) 
hypot, cabs: Euclidean distance, complex absolute value. . 2... 0... 2 2 ee hypot(3M) 
rdist: remote file distribution program. .... 2-2 ee eee eevee + Fdist(1) 
dl: DL-11 communications multiplexer. . . .... . - di(4) 
di: DL-11 communications multiplexer. . 2... 1. 2 ee ee dl(4) 
error log. dmesg: collect system diagnostic messagestoform ..... dmesg (8) 
res_mkquery, res_send, res init, dn_comp,dn_ expand: resolverroutines. ... 2... 6. resolver(3) 
res_mkquery, res_send, res _init,dn comp, dn_expand: resolverroutines. 2... 66 6 eee ee ee es resolver(3) 
doctor: interact with a psychoanalyst. . 2... 2 6 2 ee ee doctor(6) 
style: analyze writing styleofa document . 2... 2.2 ee ee ee eee teense style(1) 
refer: find and insert literature referencesin documents. . .. 2. 2. 0s eee eve eer ere nee refer(1) 

w: who ison and what theyare doing. ... 2... 2 ee eee eee ee te ee eee w(1) 
named: Intemet domain name server, . . 2. 2. 6 2 0 0 se ee eo ow ee «6Camed(8) 
named: Intemet domain name server. 2... 2 5 0 ee ee ee we ew ee aMed(8C) 

domainname: set or display name of current domain system. . . 2... 6 6 0 0 ee © ee © © © © © © GOmainname(1) 
system. domainname: set or display name of current domain - «+ « « domainname(1) 
rogue: Exploring The Dungeonsof Doom. ... 2... 2.25 eee eee eee eee e(6) 
shutdown: shut down part of a full-duplex connection. ee ee eee shutdown(2) 
shutdown: close down the system atagiventime. . .. 2... + see ee shutdown(8) 
rand, drand, irand: return random values. . .. 2.2.2. +e eee rand(3F) 
random, drandm, irandm: better random number generator, ..... random(3F) 
graph: Grawagraph, 2... 2 2 ee eee ee ee ee eee graph(1G) 
exponent manipulations. copysign, drem, finite, logb, scalb: copysign, remainder, ....... ieee(3M) 
arithmetic: provide drill inmumberfacts. . 2... 2. 2 ee ee te ee eee arithmetic(6) 
pty: pseudoterminal driver. . ...... ee ee ee ee ee ee ee pty(4) 
sp: disk spanning pseudo disk driver, 2... 1 2. 2 ee eee eee we we eee ne sp(4i) 
drtest: standalone disk test program. .. 1... 2 2 ee ee drtest(8) 
drum: paging device. 2. 2. 2 2 ewe ew ee ew ew drum(4) 
etime, dtime: return elapsed executiontime. ........... etime(3F) 
du: summarize disk usage. . 2... 6 0 ee ee ewes du(1) 
dump: incremental filesystem dump. ... 2... 2 2s eee eee eee eee ne dump(8) 
rdump: file system dump across the network, . 2... 2-6 2 ee ee ewe rdump(8C) 
rrestore: restore a file system dump acrossthe network, . 2... 2.2.2 22 ee ee ee rrestore(8C) 
dump, dumpdates: incremental dump format. ....... dump(5) 
dumpfs: dump file system information. . . 2... 2.2 2 ee ee dumpfs(8) 
dump, dumpdates: incremental dumpformat. . .. 2... 6 ee eee ee eee enene dump(5) 
dump: incremental file system dump. ..........-. dump(8) 
od: file dump (octal, decimal, hex, ascii). 9. 2... 2 ewe ee we od(1) 
savecore: save acore dump of the operating sysiem. .........-220- savecore(8) 
kgmon: generate a dump of the operating system’s profile buffers. ....... kgmon(8) 
dump, dumpdates: incrementaldumpforma. .........-. dump(5) 
dumpfs: dump file system information. ...... ° dumpfs(8) 
zork: the game of dungeon. . . 1... 2 5 2 ee eee eae gdtgl seme” ven 6 zork(6) 
rogue: Exploring The DungeonsofDoom. .......064-eeeeee808 rogue(6) 
“dup, dup2": duplicate adescriptor,. .........+-. dup(2) 
“dup, dup2": duplicate adescriptor. . 2... 1.11 eee eee dup(2) 
“dup, dup2": duplicate adescriptor, 2... 2 2 2 2 ewe ee ee es dup(2) 
dz: DZ-11 communications multiplexer. ......2.2.. dz(4) 
dz: DZ-11 communications multiplexer. . . ... 2.0... dz(4) 
echo: echoarguments. 2... 2. 2 0 we ee ee we ee ewe csh(1) 
echo: echoarguments. .. 2... 2 se ese ee evr evee echo(1) 
echo: echo arguments. . 2... 2. 2 ee ew ee we wee esh(1) 
echo: echo arguments. oa » echo(1) 
ping: send ICMP ECHO REQUEST packets to network hosts. a. aA Tee He ping(8) 
ecvt, fevt, gcevt: output conversion. . . 1... 1 ee ee ecvt(3) 
ed: texteditor, . 2... 2.2.2.2. $. ire; es oie a be Sew, ed(1) 
end, etext, edata: last locations in program. ge) leer Wa So SS end(3) 
ex, edit:textedifor, 2... se eee we te wet we we we XI) 
vipw: edit the password file. 2... 2. 2 we wee eww we vipw(8) 
edquota: edit userquotas, 2... ....20 20200 . s+ « edquota(8) 
Cds FONE CGHOE ow SS es ow Oe & Pe, OW eS Se ed(1) 
ex, edit: text editor, ....... oe trel edie teh tac ta -e festa! <6) etre Fee ex(1) 
Id: link editor, ... Bo Bios he ee cel, Hi ela: Ba ee Bade ee Id(1) 
sed: stream editor, 2... we ee te et ee ee ee tt tw sed(1) 
vi: screen oriented (visual) display editorbasedonex. . 2... 2... see eee wee ee vi(1) 
a.out: assembler and link editoroutput. 2... 6 6 2 ee ee ee eee we wes a.out(5) 
edquota: edit userquotas. 2.2... 2.2... 02 eee edquota(8) 
whoami: print effective currentuserid. 2... 0. 2.1 eee eee ee whoami(1) 
setregid: set realand effective groupID. ..........0-0202000 cee setregid(2) 
setreuid: set realand effectiveuserID’s. . . . 2-222. 22s eee ecee setreuid(2) 
vfork: spawn new process in a virtual memory efficientway. . 2. 2 6 2 se ee we eee ew ene vfork(2) 
efi: Extended Fortran Language. .........2..0. efi(1) 
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Rgrep,R egrep, fgrep: search afile fora pattem. ..... +... grep(1) 
el: disk interface. 2 2. 6 wwe we ee 6 ape Ee tee el(4) 
etime, dtime: return elapsed executiontime. .... . ee ae ee ee etime(3F) 
insque, remque: insert/remove element fromaqueue. . . . 2.2 2 + ee ee ee eee insque(3) 
. soelim: eliminate .so’s from nroff input. .... 6-2 + ee eee soelim(1) 
else: alternative commands. .... 2 - e+ ee ee eee csh(1) 
setquota: enable/disable quotas on a file vee ee ee ee setquota(2) 
wuencode: format of an encoded uuencode file. 2... 2 6 6 ee ee eo ow © e ~«UeNCode(S) 
crypt: encode/decode, 2... 2 2 we ee ee ee we rene + rypt(1) 
mail. uuencode, uudecode: encode/decode a binary file fortransmission via. ....-. wuencode(1C) 
crypt, setkey, encrypt: DES encryption, .... 2-2. ee es . crypt(3) 
crypt, setkey, encrypt: DES encryption. .... 26+... er ee crypt(3) 
makekey: generate encryptionkey. .. 2... eee eevee eee : makekey(8) 
end, etext, edata: last locations in program. os ee ee Ond(3) 
sccs: front end for SCCS (Source Code Control Subsystem). ei: Goi cee “o Xe secs(1) 
logout: endsession. . . 2... 2. ee ee ee ew ew ew ew ew ow © CI) 
ead: terminate loop. eves hte a anor oie: we tel ete Se esh(1) 
/getfsspec, getfsfile, getfstype, setfsent, endfsent: get file system descriptor fileentry. ...... . . getfsent(3) 
/getfsspec, getfsfile, getfstype, setfsent, endfsent: get filesystem descriptor fileentry. ...... . ~ getfsent(3X) 
getgrent, getgrgid, getgrnam, setgrent, endgrent: get group fileentry. . .. 2... - ee ee eee getgrent(3) 
gethostbyaddr, gethostent, sethostent, endhostent: get network host entry. gethostbyname, a ar ae gethostbyname(3N) 
endif: terminate conditional, . 2... 2 1 ee ee eww esh(1) 
getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent: get networkentry. . 2... 2 2 0 ee ee we + getnetent(3N) 
socket: create an endpoint forcommumnication. .. 2... 2. 2 ee ee eee socket(2) 
getprotobynumber, getprotobyname, setprotoent, endprotoent: get protocol entry. getprotoent, ae ae ae getprotoent(3N) 
getpwent, getpwuid, getpwnam, setpwent, endpwent, setpwfile: get password fileentry. ........ getpwent(3) 
getservbyport, getservbyname, setservent, endservent: get service entry. getservent, .... +... getservent(3N) 
endsw: terminate switch, . 2... 2 6 ee ee we we eee esh(1) 
getttyent, getttynam, setttyent, endttyent: getttys fileentry, . 2... 6 2 ee ee ee ee getttyent(3) 
getusershell, setusershell, endusershell: get legal usershells. . . 2... 2. ee eee getusershe!1(3) 
number: convert Arabic numeralsto English .. 1... 2.22 eee ger ran BE at Wer a tee tee te nhumber(6) 
‘xsend, xget, enroll": secretmail, . 2... 2 ee ee ww we we ew te eww xsend(1) 
nlist: get entries from name list. 2 2... 1 2 ee ee ew we ew plist(3) 
logger: make entries in the systemlog. . . 2... 2 2 2 ee ee eee logger(1) 
setfsent, endfsent: get file system descriptor file entry. getfsent, getfsspec, getfsfile, getfstype, ....... getfsent(3) 
setfsent, endfsent: get filesystem descriptor file entry. getfsent, getfsspec, getfsfile, getfstype, ....... getfsent(3X) 
getgrnam, setgrent, endgrent: get group file entry. getgrent,getergid, . . 2... + 2 eee ee eee getgrent(3) 
sethostent, endhostent: get network host entry. gethostbyname, gethostbyaddr, gethostent, eee gethostbyname(3N) 
getnetbyname, setnetent, endnetent: get network entry. getnetent, getnetbyaddr, . 2... 2. 2 ee eee getnetent(3N) 
setprotoent, endprotoent: get protocol entry. /getprotobynumber, getprotobyname, ........ getprotoent(3N) 
setpwent, endpwent, setpwfile: get password file entry. getpwent, getpwuid, getpwnam, .......-..-. getpwent(3) 
getservbyname, setservent, endservent: get service entry. getservent, getservbyport, ..... eka: ten cesse ues te getservent(3N) 
getttynam, setttyent, endttyent: get ttys file entry. = ee a ee es ee ee eee ee getityent(3) 
unlink: remove directory entry, ...... gost it, Cay le! (et tele os se! SS vay Cat te tee oo unlink(2) 
unlink: remove a directory entry. ae re te a’, Wee elie Merned terest ent e he les unlink(3F) 
execv, execle, execip, execvp, exec, exece, exect, environ: execute a file. OXECL, On siete ee a sk ews a Re execi(3) 
. environ: userenvironment . 2... 2... ee eee ee environ(7) 
setenv: set variable in environment. hte «Wi 28) Jes “wares caso ie “e-saccieh Yen Wien i he csh(1) 
environ: user environment. . 2... 2 6 0 ee ee we ee te th ee ww environ(7) 
printenv: print out the environment . 2.2... 2 ee eee wee ee ew printenv(1) 
window: window environment. . 2... 2 ee ee ew ee ee we te ww window(1) 
unsetenv: remove environment variables. . . 2... 6 se ee ee ee es cesh(1) 
getenv: get value of environment variables. 2. 2... 2 2 2 eee ee ee getenv(3F) 
getenv, setenv, unsetenv: manipulate environmental variables. . . 2... 2. 2 ee ee eee getenv(3) 
eqnchar: special character definitions for eqn. . . . - - eee eee ee ee ee ee eqnchar(7) 
eqnchar: special character definitions for eqn. . 2 2 6 6 ee eee et te ee we www ee es eqnchar.source(7) 
deroff: remove nroff, troff, tbl and eqnconstructs. . 2... 6 2 ee ee ee eet eee we deroff(1) 
eqn, neqn, checkeq: typeset mathematics. ae eae oe ae ae eqn(1) 
eqnchar: special characterdefinitionsforeqn. ....... eqnchar(7) 
eqnchar: special character definitions foreqn. ....... eqnchar.source(7) 
linemod, space, closepl: graphics/ plot: openpl, erase, label, line, circle, arc, move, cont, point, .. ... . . plot(3X) 
erf,erfc:errorfunctions. ©... 2. 2. 1 eee ee es erf(3M) 
erf, erfc:errorfunctions. .. . 2... 2 0 ee ee ee ee © OGM) 
Messages. error: analyze and disperse compilererror . . 1... 1... error(1) 
erf,erfe: errorfunctions. .. 6... 6 2s ee ee ww eww we erf(3M) 
dmesg: collect system diagnostic messages toform errorlog. .. 2... se ee ee ee we wwe wrens dmesg(8) 
mkstr: create an error message file by massaging C source. . 2... 2. 3s mkstr(1) 
error: analyze and disperse compiler error messages.  . 2 6 2 ee ee ee ee ee eee ws error(1) 
petror, sys _errlist, sys merr: system errormessages. «2. 2 6 6 6 ee ee eee wt ee wt perror(3) 
perror, gerror, iermo: get system error messages. ee ee ee ee ee perror(3F) 
intro: introduction to system calls and errormumbers. .. . 2. 20 ee eee eee we ws intro(2) 
spell, spellin, spellout: find spelling errors. 5 2 2 6 ee ee ee eee ee wwe ww ene spell(1) 
traper: trap arithmetic error. 2 6 6 0 ee ee te et et te tt es traper(3F) 
jeschinals mounted file systemtable. 2.2... ...... mtab(S) 
end, etext, edata: last locations in program. ........2.. end(3) 
ex: Excelan 10 Mb/s Ethernetcontroiier, ©... 2.2... 22. es ee ee ewes ex(4) 
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il: Interlan 10 Mb/s 
nw: Integrated Solutions, Inc., 10 Mb/s 
nwstat— report 


hypot, cabs: 
lif, while, :, . , break, continue, cd, 


expr: 
history: print history 
screen oriented (visual) display editor based on 


Ipq: spool queue 

uug: 

ex: 

execl, execv, execle, execlp, execvp, 
fwhile, : , . , break, continue, cd, eval, 


execl, execv, execle, execlp, execvp, exec, 
exect, environ: execute a file. 
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Ethernet controller, . 2... 6 0 ee ew eee a etiec Sets, he il(4) 
Ethernet controller. Be Se. Ye iat OES le vekocie Ze oe ee + 6BW(4i) 
Ethernet Packet Transmission Firmware status. . ...... nwstat(8) 
etime, dtime: return elapsed execution time. ........ etime(3F) 
Euclidean distance, complex absolute value. ....-- +. - hypot(3M) 
eval, exec, exit, export, login, read, readonly/ ....... sh(1) 
eval: re-evaluate shell data. 2. 2. 6 2 ee ee ee ees csh(1) 
evaluate arguments as an expression. . 2... 6 es ese expr(1) 
eventlist. ......6. Har wh Soe DOE ie es eas ig esh(1) 
OX VES fe ose. ee ie ey cee lean tee) Brie a eh Se OO ence vi(1) 
ex, edit: text editor. . . 6: Den teks Vee) en 0 - ex(1) 
ex: Excelan 10 Mb/s Ethernet controller. aOR Te ee oe © ex(4) 
examination program. .. 1... 1 6 ee ee ee eee Ipq(1) 
examine or manipulate the uucpqueue. ..... .~ eee + Uuq(IC) 
Excelan 10 Mb/s Ethernet controller. . 2... 2.2. + eee ex(4) 
exec, exece, exect, environ: executeafile. . . 2... eee execl(3) 


exec, exit, export, login, read, readonly, set/ ........ sh(l) 

exec: overlay shell with specified command. ........ csh(1) 
exece, exect, environ: executea file. . . . . 2. + + + + « - execi(3) 
execl, execv, execle, execlp, execvp, exec, exece, .... . . execi(3) 


environ: execute a file. execl, execv, execle, execlp, execvp, exec, exece,exect, 2. 2 + se es - execi(3) 
execute a file. execl, execv, execle, execlp, execvp, exec, exece, exect,environ: «2. 2 ee ee execi(3) 
execl, execv, execle, execlp, execvp, exec, exece, exect, environ: executeafile. 2... 2. 2 2 eee ee eee execi(3) 
execlp, execvp, exec, exece, exect, environ: execute a file. execl,execv,execle, . . . 2... + + es ~~ e@xeci(3) 
execve: executeafile ..... atcatis: eudercele eetenen eines + + execve(2) 
alarm: execute a subroutine aftera specified time. .......-. alarm(3F) 
system: executea UNIX command. ..... 22. 2 ee ee eee system(3F) 
repeat: execute command repeatedly. . . 2. 2 2 6 + 6 6 so ee © Coh(l) 
at: execute commands atalatertime. .......2.2.2.2s. at(1) 
lastcomm: show last commands executed in reverse order. ....--.-.- sation te xe xfer tel lastcomm(1) 
uux: unix to unix command execution .......0-. Siresyfe Gi, far Jen lb Corse Se. ete uux(1C) 
acct: execution accounting file. ..... ib: lis fe, agit'es ese ceh es acct(5) 
uuxqt: UUCP execution file interpreter. . . 2. 2. 2 2 2 ee eee eee uuxqt(8C) 
sleep: suspend executionforaninterval .. 2... ++. -+-++s +e ee- sleep(1) 
sleep: suspend executionforaninterval, .. 2... 2-2 ee eee eee sleep(3F) 
sleep: suspend execution forinterval. .... . Sie Ne ae, Be, 8 sleep(3) 
usleep: suspend executionforinterval, . 2... 2. 2 eee ee ee eee usleep(3) 
monitor, monstartup, moncontrol: prepare execution profile. . . 2... 2. 2 2 se ee ee ee ee monitor(3) 
rexecd: remote execution server. .... ; Gate Ca eS fats Seow o? 26) Gee, fea rexecd(8C) 
etime, dtime: return elapsed executiontime. ...... S: Yes ei ta <a, eM ih te eee: cor etime(3F) 
profil: execution time profile. .. 2... 2. ee ee eee eee profil(2) 
environ: execute a file. execl, execv, execle, execlp, execvp, exec, exece,exect, . ..... execl(3) 
execve:executeafile, 2... 1. 0 ew wee eee we ee execve(2) 
file. execl, execv, execle, execlp, execvp, exec, exece, exect, environ: executlea2 ....... execl(3) 
link: make a link toan existingfile. ..... hivea det vor ih panties deli corniny autar a fe link(3F) 
tunefs: tune upan existing filesystem. . . 2... 2 2 1 2 eee ee eee tunefs(8) 
/:, ., break, continue, cd, eval, exec, exit, export, login, read, readonly, set,shift/ ........ sh(1) 
breaksw: exit fromswitch, . .. 2.6. 0 0 ee ee eo ee ee ewe esh(1) 
exit:leaveshell, 1. 2... 2 2 0 ew ee eee ee ae csh(1) 
_exit: terminate a process. 2. 6 2 2 2 ee eee ee eee exit(2) 
pending output. exit: terminate a process after flushing any ......... exit(3) 
exit: terminate process with status. . . 2... 2.25200 exit(3F) 
break: exit while/foreach loop. . . 2... 22 ee ee eee esh(1) 
logarithm, power. exp, expm1, log, logl0, loglp, pow: exponential, gra Rites tas exp(3M) 
glob: filename expand argument lis. . 2... 0. ee ee ee ee we cesh(1) 
compress, uncompress, zcat: compress and expanddata. ...... +2 .ese2o-e ae ae ee compress(1) 
expand, unexpand: expand tabs to spaces, and vice versa. SG hs U6 0. sey owen expand(1) 
versa. expand, unexpand: expand tabs to spaces, and vice... . . expand(1) 
diction. diction, explain: print wordy sentences; thesaurusfor ........ diction(1) 
adventure: an explorationgame. ...:.... CM ESS Sle adventure(6) 
rogue: Exploring The DungeonsofDoom. ........... rogue(6) 


logarithm, power. exp, 

frexp, ldexp, modf: split into mantissa and 
drem, finite, logb, scalb: copysign, remainder, 
exp, expm1, log, log10, log1p, pow: 

/ ., break, continue, cd, eval, exec, exit, 


expr: evaluate arguments as an 
re_comp, re_exec: regular 
addbib: create or 

efi: 

strings. xstr: 


ioinit: change 
libraries.. plot: openpl et al.: 
tclose, tread, twrite, trewin, tskipf, tstate: 
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expm1, log, log10, logip, pow: exponential, ....... . exp(3M) 
exponent. a ee ers een 


exponent manipulations. copysign, ......... ieee(3M) 


exponential, logarithm, power, .. 2... 2... ee eee exp(3M) 
export, login, read, readonly, set, shifi,times/ ....... sh(1) 
expr: evaluate arguments as an expression. .....2.2.. expr(1) 
Expression. . 2.4 2 ee ew we we te ww eo ee + expr(t) 
expressionhandler. . .. 2.2.2 ee eee ee ee regex(3) 
extend bibliographic database. .......-. 2.0.0. addbib(1) 
Extended Fortran Language. . . 1... 2-2 ee ee eee efi(1) . 
extract strings from C programstoimplement shared .. . . xstr(1) 
f77: Fortran 77 compiler, . 2... 6. ee ee ee wee f77(1) 
f77 VO initialization, 2... 1 1 ee ee ee ee ioinit(3F) 
{77 library interfaceto p1ot (3X) .......... plot(3F) 
f77 tape W/O. topen, ....- ee es ec Rc wile de ens topen(3F) 
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ceiling, and round-to-nearest functions. fabs, floor, ceil, rint; absolute value, aia Slates, for er etree ee % floor(3M) 
networking: introduction to networking facilities. . ......2.026-. ai ete: ata onl Gee Gait s ; intro(4N) 
signal: simplified software signal facilities. . . 2... 2 2 ee ee ee ee ee tte signal(3C) 
sigvec: software signal facilities. . 2... 1 1 ee ee eee we ewe we ww ne sigvec(2) 
malloc, free, falloc: memory allocator, .....-.-+.- tae teas ate malloc(3F) 
true, false: provide truth values. 2 2. 6 6 6 ee ee ee es true(1) 
false, true: provide truth values. 2. 2 6 6 6 6 ee ee ew false(1) 
inet: Internet protocol family, ........ be <a ce Aisa ole cectel «eine Sab rosne Vet xe inet(4F) 
checking the disks. fastboot, fasthalt: reboot/halt the system without a oe a fastboot(8) 
the disks. fastboot, fasthalt: reboot/halt the system without checking ...... fastboot(8) 
abort: generatea fault.  . 2... 22 se ew ewe we we we ee rene abort(3) 
trpfpe, fpecnt: trap and repair floating point faults. ....... ee ee ee ae ee ee ee trpfpe(3F) 
locate a program file including aliases and paths (c s h only). which: . . 2... 26 2 ee eee eee which(1) 
export, login sh, for, case, if, while, :, . , break, continue, cd, eval,exec,exit, . ...-. +... sh(1) 
exit, export, login, sh, for, case, if, while, :, ., break, continue, cd,eval,exec, . 2.2... 2. ees sh(1) 
plot: openpl et al.: £77 library interfaceto p I o t (3X)libraries.. .....-. . plot(3F) 
nice, nohup: run a command at low priority (s h only). . 2... 6 2 ee ee ee . + + + + Rice(1) 
fclose, fflush: close or flush a stream. ..... + 2 + « fclose(3S) 
fentl: file control. 2. 6 2 6 we ew ee ee ws . » « fentl(2) 
ecvt, fevt, govt: output conversion, . . 2. 6 6 ee ee ee eo Covi) 
fdate: return date and time in an ASCII string. ‘ fdate(3F) 
fopen, freopen, fdopen:openastreaam. . 2. 2. 2 2s 6 ee ee ee eee fopen(3S) 
ferror, feof, clearerr, fileno: stream status inquiries. ates folic. ew ete ferror(3S) 
inquiries. ferror, feof, clearerr, fileno: stream status. ww 1 1 1 ee ferror(3S) 
subroutines. dbminit, fetch, store, delete, firstkey, nextkey: database ..... . . dbm(3X) 
head: give first fewlines. 2. 2... 2 ee eee eee wee ee eee head(1) 
fclose, flush: close or flusha stream. . 2... 2. 62 ee ee eee fclose(3S) 
extreme values. fimin, filmax, ffrac, dfimin, dfimax, dffrac,inmax: retum ......... fimin(3F) 
bcopy, bemp, bzero, fis: bit and byte string operations. . 2... 2-1 se eee bstring(3) 
fg: bring job into foreground. . 2. 1 2 6 eee et ew csh(1) 
getc, fgetc: get a character from a logical unit. elie a5) <a Sash eSBs cet, getc(3F) 
getc, getchar, fgetc, getw: get characteror word from stream. ....... getc(3S) 
gets, fgets: get a string fromastreaam. . . 2... 2 + ee wee gets(3S) 
R grep, Regrep, fgrep: searchafileforapattem. .. 2... 2-2 ee eee grep(1) 
robots: fight off villainous robots. 2... 6 6 ee ee ee ew robots(6) 
access: determine accessibility of file. ...... Realise Jeg'ey Cente teneicsels Wk a ties, atin ee teh Se access(2) 
access: determine accessibility ofa file. 2. 2. 2 0 2 eee eee ee te tw ew wes access(3F) 
acct: execution accounting file. SPS e ei et Sr aehke cen ee) ya ete as et fe GI AP acct(5) 
chmod: change mode of file. ........ Se ee er ee ee er ae chmod(2) 
chmod: change mode ofa file. 2... 2 eww ee we ee ee we we wwe we tw ws chmod(3F) 
chown: change owner and groupofa file, 2... 2. 6s eee ee we wee we we we we ews chown(2) 
; colrm: remove columns froma file. .... . Sone Gi aewteiete sowie! verse" tes Mecvats iS: love SE cau Ze colrm(1) 
core: format of memory image file, 2... 2... 2 0 eee wwe we ww we ew wwe core(5) 
creat: createanew file. ....... Sr oes at coi cel-ercey so vec Seite Ge wees creat(2) 
source: read commands from file. .......4... Pas shi colt “ede te. ates ee csh(1) 
Ctags: createatags file. 2... 1... ee ee eevee ie Bo hie at Bo. PS ctags(1) 
dd: convertand copya file. 2... 2. 2 2 2 eee ee we ee wee ww wee dd(1) 
disktab: disk description file. ....... Sieh eee eo eet tee a sh SE alee SY ars disktab(5) 
execvp, exec, exece, exect, environ: execute a file. execl,execv, execle,execlp, . 2... 2s ee eee execl(3) 
execve: executea file. ...... SW ieh ol es Vertis. cat ety aes ee ERS CO Tels execve(2) 
flock: apply or remove an advisory lock on anopen file, 2... 1 2 ee ee eee wee we we we eww flock(2) 
fpr: print Fortran file. ........ a oe ee a ee . . fpr()) 
group: group file. ........2-2.20-. Stee ee Ya ie Me Na ge Son we ee group(5) 
L.aliases: UUCP hostname alias file. . 2... 2. 6 ee ee ee wee we we ww ewan Laliases(5) 
L.cmds: UUCP remote command permissions file. 2... 1 2 ee ee ee ee we eww ew enw L.cmds(5) 
L-devices: UUCP device description file. 2. 2... 2 2 ee ee ee ee ete ee ee ns L-devices(5) 
' L-dialcodes: UUCP phone number index file. .......-.4-. Ot ee Se et en ee ew LS L-dialcodes(5) 
link: make a hard linktoa file. ...... Boies oslo eile iatecer. fe iS we g!8 an etter tee te link(2) 
link: make alink toanexisting fille. 2... 6. 2 we ewe ewe we wee eevee s link(3F) 
L.sys: UUCP remote host description file. 2. 2... 2 ee eee te ee ee ee ee es L.sys(5) 
mkdir: make adirectory file. 2... 1. ww eww wwe were ewe een ne mkdir(2) 
mknod: make a special file. ... . ae ie oe ee ee : mknod(2) 
mknod: build special file. . 2... 1.2252. Sai enehts . « » mhknod(8) 
rebuild the data base for the mail aliases file. newaliases;s ........2.. A . . mewaliases(1) 
open a file for reading or writing, or createamew file. open: 2 2 1 1 0 ee ee et ee ee we wee open(2) 
passwd: password file. . 2... 2.2.26 Be Sag ee Cer Rl gh at ic ae aa ey passwd(5) 
pr: print file. 2... 1 2 eee eters sees pr(1) 
remote: remote host description file. ...... ee ork a SR, Oe wom ae ate eG ag remote(5) 
rename: change the name ofa file. . 2. 2... 6 2 ee ee ee ee ew we we we ews rename(2) 
rename: renamea file. . . 2... 0 ee we ee eee ww we we wae rename(3F) 
resolver— resolver configuration file. . . 2... 6 ee ee ee ee ee eee ene resolver(5) 
rev: reverse linesofa file. 2. 2... 6 0 1 ee ww ee ee we we ww wae rev(1) 
rmdir: remove a directory file, 2 2 66 6 ee eee wee ee eee ew eee ne rmdir(2) 
size: size of anobject fille. . 2. 2 2 eee ee ee te ee we ee eww ene size(1) 
the printable strings in a object, or other binary, file. strings:find . . 2... 2 ee ee eee eee evne strings(1) 
sum: sum and count blocks ina file. . 2... 6. 2 ee eo ee ee ew ww we we wet sum(1) 
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symlink: make symbolic link toa file. .... Sie eS ee Re Sw oe + « + symiink(2) 
tail: deliver the last partofa file. . . Bae aie Me INE Se Se ee: ta a eae tail(1) 
touch: update date last modified ofa file. ...... ie ee Coe we eee ee ee ee touch(1) 
uniq: report repeated lines ina file. . 2... 2.2 ee ee eevee eo ee © © © 6UNig(1) 
USERFILE: UUCP pathname permissions file. . 2... 2 2 ee ee ee ee ee eee ‘ - USERFILE(S5) 
uuencode: format of an encoded uuencode file. . 2... 2.2. 2 eee ee eee beta be ee 0 wuencode(5) 
vipw: edit the password file, 2... 2 2s ee ee ee ee ee ew ee wwe - . Vvipw(8) 
versions of object modules were used to construct a file. what: showwhat ......-+-22 eee + + « « « What(l) 
diff: differential file and directory comparator. See aie ei eee. F . diff(1) 
bugfiler: file bug reports in folders automatically, ......- . » bugfiler(8) 
mkstr: create an error message file by massaging C source. 9 . 2. 2 2 2 wee ee eee mkstr(1) 
diff3: 3-way differential file comparison. ...... re ee a ae ee ee . . diff31) 
fentl: filecontrol . 2.5. 2... ee we eee ew we eee . « fenti(2) 
rep: remote file a) Wine ee oe OS Wl te a gai foe ah rep(1C) 
umask: change or display file creation mask. . BES ek Sine. FOr eh teeie Gk SUR ess esh(1) 
umask: set file creation mode mask. eh a Yet ol Se Mears eee aI . umask(2) 
file: determine filetype. 2... .....0-2+200 file(l) 
rdist: remote file distribution program. er a err rr. 60) 
od: file dump (octal, decimal, hex, ascii). ees ee. acerca we 8 OdG) 
setfsent, endfsent: get file system descriptor file entry. /getfsspec, getfsfile, getfstype, cee eo oe ee getisent(3) 
setfsent, endfsent: get filesystem descriptor file entry. /getfsspec, getfsfile, getfstype, ........-.- getfsent(3X) 
getgrgid, getgrnam, setgrent, endgrent: get group file entry. getgrent, . 2... 2 2 2 2 ee eee ee ee getgrent(3) 
setpwent, endpwent, setpwfile: get password file entry. getpwent, getpwuid, getpwnam, ........ getpwent(3) 
getttynam, setttyent, endttyent: get ttys file entry. getttyent, . 2... 2.2 2 ee ee eee eee getttyent(3) 
R grep, Regrep, fgrep: searcha fileforapatiem. . 2... 2 2 ee ee eer eee eee grep(1) 
open: open a file for reading or writing, or create a new file. ib te Santas at ary open(2) 
aliases: aliases fileforsendmail, .. .. 2... ee ee ee eee vas aliases(5) 
- wuencode, uudecode: encode/decode a binary file for transmission via mail eovaih ie! (otra ve! eta ve uwuencode(1C) 
ar: archive (library) fileformat. . 2... 1. 2 eee we eee ee wens ar(5) 
tar: tape archive fileformat. ......-2.2-25000-s Si fe fe, ome teres tar(5) 
which: locate a program file including aliases and paths (¢ shonly). ....... which(1) 
chfn, chsh, passwd: change password file information. .. . 2... 2.2 ses eee ee eee passwd(1) 
uuxqt: UUCP execution file interpreter. . .. 2... aide sat oneal dat dae ce Heh -e koe Ne uuxgt(8C) 
fsplit: split a multi-routine Fortran file into individual files. 2... 2... 2 2 eee eee ee fsplit(1) 
split: splita fileintopieces. 2. 2... 2 ee we ee ee ew ee split(1) 
pmerge: pascal filemerger, . 2. 2 2 2 0 2 ee ee ew ee wee we pmerge(1) 
fseek, ftell: reposition a fileonalogicalunit . 2... 2.2 ee ee eee eee fseek(3F) 
more, page: file perusal filter forcrt viewing. . ... 2... 2 2 ee ee more(1) 
Stat, Istat, fstat: get filestatus, 9. 2.6. 1. ee ee te ee te ee es stat(2) 
stat, Istat, fstat: get filestatus. 2. 2... 2 ee eee tt ee tt tt ew stat(3F) 
mkfs: construct a file system. . . Bee Beret net [on tnw eye en te vee Ath lee ei mkfs(8) 
mkproto: construct a prototype file system. . . a ee os iat Dei ata e: as os mkproto(8) 
mount: mount file system. . ... 2... 2. ee oe 6 ioe VES GS, Be mount(2) 
newfs: constructa new filesystem. . 2... 2... 2 es ee wee ee een e newfs(8) 
repquota: summarize quotas fora filesystem. . 2... 2.2 ee eee ewe ween repquota(8) 
setquota: enable/disable quotas ona filesystem. . 2... 2 2 ee ee eee ee ee ee setquota(2) 
tunefs: tune up an existing file system. .... . F exlens ew fee Abs Ye tunefs(8) 
unmount: remove a filesystem. . 2... 2.2.2 see wee eee eevee unmount(2) 
repair. fsck: file system consistency check and interactive 6 as Oo BEE: fsck(8) 
getfsfile, getfstype, setfsent, endfsent: get file system descriptor file entry. /getfsspec, ........ getfsent(3) 
dcheck: file system directory consistency check. . ......2..6. dcheck(8) 
dump: incremental file system dump. 6G ein'a Peete OS See Ge Ae esa nel Bi 20s te dump(8) 
rdump: file system dump across the network. Sue ee ler.) Cet ele eae rdump(8C) 
rrestore: restore a file system dump across the network, . 2... 2... 0 es trestore(8C) 
dumpfs: dump file system information, .. 2... 1... 2 ee eevee dumpfs(8) 
quot: summarize file system ownership, .. 2... 1.2... ee ee eee ot(8) 
quotacheck: check file system quota consistency. ....... ee ire ME ae quotacheck(8) 
quotaon, quotaoff: turn file system quotasonandoff. .........-.4ee06-6 quotaon(8) 
restore: incremental file system restore. 2... 2. 0 ee ee ee ew we ee ws restore(8) 
icheck: file system storage ener ee ettbs estes 35 3 icheck(8) 
/etc/mtab: mounted file systemtable. . . 1... 2. 20 eee eee mtab(5) 
fs, inode: format of file sysiem volume. . .. 2.2... 2 ee eee we ee ce £8(5) 
utime: set filetimes. . 2... 0 1 ee ee eee ween . « utime(3C) 
utimes: set filetimes. . 2 2. 1 2 ee we ee ee www we ww ew © «Utimes(2) 
uusend: senda filetoaremotehost. ......:3..6.028c0c8c8ce8e8 uusend(1C) 
truncate: truncate a file toa specifiedlength, . 2... 1 2 1 ewe wre e we truncate(2) 
ftp: ARPANET file transfer program. .. 2. 2 2 ee ee eee : fip(1C) 
tftp: trivial file transfer program. . . 2... ee ee ee ee ee tftp(1C) 
ftpd: DARPA Internet File Transfer Protocol server. . 2. 2. 2 1 1 2 we ew eee ftpd(8C) 
tftpd: DARPA Trivial File Transfer Protocol server. . 2. 2. 2. 2. ee ee eee tfipd(8C) 
file: determine filetype. 2... 6 6 ee ee ee eee inte; ec tae ae file(1) 
mktemp: make aunique filename. ..... s+ ses StS de Be Ses Vo Roe ee mktemp(3) 
basename: strip filename affixes. 2. 2 2 6 6 2 ee eee we ewe ew basename(1) 
glob: filename expand argument lis. 2... 2... ww eee esh(1) 
ferror, feof, clearerr, fileno: stream status inquiries. . . 2... .....008-6 ferror(3S) 
checknr: check nroff/troff files. . 2... 2.6 2 ee ee ee te we we ewe ee ee checknr(1) 
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cmp: compare two 
comm: select or reject lines common to two sorted 
config: build system configuration 
find: find 
split a multi-routine Fortran file into individual 
lockf: provide advisory record locking on 
makedev: make system special 
R mv: move or rename 
sort: sort or merge 
spconfig: build spanned disk configuration 
uulog: display UUCP log 
intro: introduction to special 
catman: create the cat 
fsync: synchronize a 
rm, rmdir: remove (unlink) 
uucico, uucpd: transfer 
badsect: create 
getfsfile, petfstype, setfsent, endfsent: get 
hier: 
fstab: static information about 
mount, umount: mount and dismount 
more, page: file perusal 
colcrt: 
col: 
plot: graphics 
refer: 
find: 


look: 

manual. man: 

ttyname, isatty, ttyslot: 

ttynam, isatty: 

lorder: 

lookbib: build inverted index for a bibliography, 
spell, spellin, spellout: 

binary, file. strings: 


manipulations. copysign, drem, 

fold: fold long lines for 

nwstat— report Ethernet Packet Transmission 
head: give 

dbminit, fetch, store, delete, 

fish: play ‘‘Go 


extreme values. fimin, 


return extreme values. 

trpfpe, fpecnt: trap and repair 

trapov: trap and repair 

infnan: signals invalid 

file. 

and round-to-nearest functions. fabs, 
fabs, floor, ceil, rint: absolute value, 
rm: DEC RX02 

rxformat: format 

fclose, fflush: close or 


flush: 

exit: terminate a process after 

/gcd, invert, rpow, msqrt, mcmp, move, min, omin, 
/mcmp, move, min, omin, fmin, m_in, mout, omout, 


device. 

fold: 

bugfiler: file bug reports in 

vwidth: make troff width table for a 
_ vfont: 


fg: bring job into 


idate, itime: return date or time in numerical 
dmesg: collect system diagnostic messages to 
ar: archive (library) file 

dump, dumpdates: incremental dump 
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files. ae a a ee a we! Be eo - - emp(1) 
PlOR. 5: ee rock eee PSS sth ee fers setae pas ah ee Bae comm(1) 
MUGS? 628s rss. S25. GS Wee Wee Se Oe! Da aS config(8) 
FLOR: o> nes 6 ce! Fe: Seis ahts, We Koi cek Se le ree ee ee eee find(1) 
MES TEDUS ie: as Seca oe ws ae te nk EE eR a a. fsplit(1) 
WOE oe ace oe ee) Oh OR Se OS Oo lockf(2) 
HNO SS csd EEE a acs = en Rie 6 5 a OS BLK makedev(8) 
Gln. eee Woden lo RP ww er We ee SE RS mv(1) 
files. . erie. alae if oo eo Tehiaer vee eee 28s sort(1) 
i: Se a ae ae ae oe ee ee oe  «Spconfig(s) 
ERs. 5. ee Se HBO], ee ogee me ae uulog(1C) 
files and hardware support. 2... 2 6 0 ee ee ee ee . intro(4) 
files forthe manual. . 2... 1... 22 es i 4, Bee ael catman(8) 
file’s in-core state with that on disk. seul be elo rae der ce fsync(2) 
files or directories. . 2... 1. 2 2 eee 5 elie oo iiss A rm(1) 
files queued by uucporuux, . 2. 2-2 6 ee ee eee . wucico(8C) 
files to contain bad sectors. . ... gh ge iag eae aes badsect(8) 
filesystem descriptor file ony: igetfsspec, S site saat cw e getfsent(3X) 
filesystemhierarchy, ... 2... es Scene Mencgts eh teaey 2 hier(7) 
filesystems. . 2... 2... ee Sexe ec ss . + - © fstab(5) 
filesystems. .....-2.-02002 ee ee ee mount(8) 
filter forcrt viewing, . 2... 1 2 2 ee ee ee ee ws more(1) 
filter nroff output for CRT previewing. 5 ice te Tac ap Lda ag colert(1) 
filter reverse line feeds. 1... 0. 2 2 ee ee we we we we col(1) 
pi), a ar plot(1G) 
find and insert literature references i indocuments. ...... refer(1) 
find TOG ge gai ne SS Bele ee Bee Se Oe find(1) 
find: find files. 2... 11 1 eee wwe ww we ewe find(1) 
find lines ina sorted list. 2... 0.0. 1 ee we ee we we ewe look(1) 
find manual information by keywords; printoutthe ..... man(1) 
find name of aterminal,. . . 2... 2.1. 2 ee eee wee ttyname(3) 
find name of aterminal port... 2. 2 2 0 ee ee ee ttynam(3F) 
find ordering relation for an object library. . .......-. lorder(1) 
find references in a bibliography. indxbib, ........ lookbib(1) 
find spelling errors. 2 2. 1 1 1 2 ee ee ee ew te es spell(1) 
find the printable strings in a object,orother ........ strings(1) 
finger: user information lookup program. ....... . ~ finger(1) 
fingerd: remote user information server. . ....... ~~ fingerd(8C) 
finite, logb, scalb: copysign, remainder, exponent 2 + ee + © feee(3M) 
finite width output device. 2... 6 2 ee ew ee ee  fold(l) 
Firmware status. . 2... 2 6 5 ee ee a? ote + « nwstat(8) 
firstfewlines. 2... 6 0 we ee ee we ww we ww  o ~=ead(l) 
firstkey, nextkey: data base subroutines. DRe ion’ : « dbm(3X) 
PER a? sie, Sake See wees we eek 8 oe af ta ae: 28 cas fish(6) 
fish: play ‘“‘GoFish’. 2... 2 2 ee ee ee ee wn fish(6) 
fimax, ffrac, dfimin, dfimax, dffrac,inmax:retum ...... fimin(3F) 
fimin, fimax, ffrac, dfimin, dfimax, dffrac,inmax: ...... fimin(3F) 
floating pointfaults. 2... 1.6 2 1 ewe ew ewe upfpe(3F) 
floating point overflow. 2... 2.2.2 22 eee eee ee trapov(3F) 
floating-point operations on a VAX (temporary). ...... infnan(3M) 
flock: apply or remove an advisory lockonanopen ..... flock(2) 
floor, ceil, rint: absolute value, floor, ceiling, ........ floor(3M) 
floor, ceiling, and round-to-nearest functions. ....4... floor(3M) 
floppy disk interface. . 2... 2 2 eee ee ee eee e m(4) - 
floppy disks. 2 0 6 cee eee eee te we we rxformat(8V) 
flushastreaam. .. 1... 2.2.22. eb RUE eaters fclose(3S) 
flush: flush output to a logical unit. . . 2... 2... . « . flush(3F) 
flush output toalogicalunit, 2... 1... 1 ew ee ee flush(3F) 
flushing any pending output, 2. 2 2. 2 2 2 eee ee ee exit(3) 
fmin, m_in, mout, omout, fmout, m_out, sdiv, itom:/ + mp(3X) 
fmout, m_out, sdiv, itom: multiple precision/) ....... mp(3X) 
fmt: simple text formatter. . 2... 22-2 ee eee ee fmt(1) 
fold: fold long lines for finite width output... . 2... .. fold(1) 
fold long lines for finite width output device. . . . ... . . fold(1) 
folders automatically, . 2... 2. 6 2 ee ee ee ewe bugfiler(8) 
b (| SN er eS ee er ee vwidth(1) 
font formats for the Benson-Varian or Versatec. ...... vfont(5) 
fopen, freopen, fdopen:openastreaam. ......... « fopen(3S) 
foreach: loop over listof names. . 2... 2 2 6 2 eee ee esh(1) 
foregromd. (§. 2 5 ee ete ew we ee es esh(1) 
fork: create a copy of this process. . ..... et oe ee fork(3F) 
fork: create anew process. 2. 6 2 6 ee ee ee te ee fork(2) 
HOM Ere ine, 6r eee we a ee Se as idate(3F) 
form errorlog. ....- - a> et Bie or Se, Mee we ee dmesg(8) 
TOPINALS, ese: oe aa SS SK eS ew we 5) 
format: es cs: ape Sk eS A cele le ee ee Oe ee dump(5) 
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tar. tape archive file 
indent: indent and 
rxformat: 
htable: convert NIC standard 
_ gettable: get NIC 
vtroff, or troff. vip: 
uuencode: 

dir: 
fs, inode: 
core: 

ti: 
tp: DEC/mag tape 
vfont: font 

scanf, fscanf, sscanf: 
printf, fprintf, sprintf: 
fmt: simple text 


ratfor: rational 

fpr: print 

fsplit: split a multi-routine 

efi: Extended 

intro: introduction to 

putc, fputc: write a character toa 

struct: structure 

e. 
login, sh, for, case, if, while, :, . 
exit, export, sh, for, case, if, while, : 

tpfpe, 


printf, 

pute, putchar, 
putc, 

puts, 

liszt: compile a 


df: disk 

malloc, 

malloc, 

fopen, 

exponent. 

from: who is my mail 
SCCS: 


scanf, 
mklost+found: make a lost+found directory for 


repair. 


individual files. 


stat, Istat, 
stat, Istat, 
on disk. 
fseek, 
fseek, 

time, 


shutdown: shut down part of a 

tn3270: 

lgamma: log gamma 

asinh, acosh, atanh: inverse hyperbolic 
bit: and, or, xor, not, rshift, Ishift bitwise 
erf, erfc: error 

value, floor, ceiling, and round-to-nearest 
intro: introduction to library 

intro: introduction to compatibility library 
intro: introduction to FORTRAN library 
intro: introduction to mathematical library 
intro— introduction to network library 
intro: introduction to miscellaneous library 
50, jl, jn, yO, y1, yn: bessel 
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formats oo 6. ete el a SS OR De HS tar(S) 
format C program source. . 2... 2 0 ee Pa ere eee indent(1) 
format floppy disks. ......4.. ip “aoc erhg a Sa ae rxformat(8V) 
formathosttables. 1... 0 ec eee ee ee wee htable(8) 
format host tablesfromahost .. 2... 6. 6 2 ee eee gettable(8C) 
Format Lisp programs to be printed with nroff, ....... vip(1) 
format of an encoded wuencode file. . 2. 2... 0 ee eae wuencode(5) 
format of directories. 2... 1. 2 se ew we ee eee dir(5) 
format of file system volume. ... 2... 2.22 ee ee fs(5) 
format of memory image file. ... 2... 1.2.2 ee eee core(5) 
format tables for nroff or troff. 6. 6 1 1 ww ee ee ew thi(1) 
ROPMIME 6-6 rk era es oe ea Se eer ase ake tp(5) 
formats for the Benson-Varian or Versatec. oe 0 oo oe «6 Vfont(S) 
formatted input conversion. ........ tale et aS scanf(3S) 
formatted output comversion. . 2. 2 2 2 cee ee ees printf(3S) 
formatter. ... 2.2... ei eryeile: sex ot eh cen lene . . fmt(1) 
formatting, . 2. 2.2 2 ee cece rv eee . « » Broff(1) 
formatting and typesetting, . 2. 2 6 6 0 ee ee ee ee Oil) 
formatting papers. . 2... 2 ee eee ee eee » me(7) 
Fortran 77 compiler. . . i. afte: eo Men wa oe e+ £77(1) 
Fortran dialect PT ees ak at ae Se Ss es a Te ee - ratfor(1) 
Fortran file. 2. 2 2. 2 ee eee wees : - fpr) 
Fortran file into individual files. . 2... 2 2 ee ee eee fsplit(1) 
Fortran Language. . bole tes tea Aas Sa ee es efi(1) 
FORTRAN library functions. pinta aie! ston ai, wo Uemie) uaa er ex tey.cs intro(3F) 
fortranlogicalunit. 2... 1 2 ee we ew ew we ww putc(3F) 
Fortran programs. .. 2. 2 2 ee ee eee ee we struct(1) 
fortune: print a random, hopefully interesting, ....... fortune(6) 
, break, continue, cd, eval, exec, exit, export, ........ sh(1) 

5 ts » break, continue, cd, eval,exec, . 6.2... 20205686 sh(1) 
fpecnt: trap and repair floating cme faults. 2... ee eae trpfpe(3F) 
fpr: print Fortranfile. . .......2-6.2226220448-4 fpr(1) 
fprintf, sprintf: formatted output conversion. ae ew “eo ek site printf(3S) 
fputc, putw: put characterorwordonastreaam. ....... putc(3S) 
fputc: write a character to a fortran logical unit. ....... putc(3F) 
fputs: putastringonastreaam. ...... 6+ eee ee puts(3S) 
Franz Lisp program. 2... 2 2 ee ee eee ee ene liszt(1) 
fread, fwrite: buffered binary input/output. .......2.. fread(3S) 
PPOs oasis oye leeigs CaP at fe 56, 6s Yep sas Sel es Cee Es df(1) 

free, failloc: memory allocator, .. 2... 5 ees see malloc(3F) 
free, realloc, calloc, alloca: memory allocator. ....... mailoc(3) 
freopen, fdopen: openastream. . 2. 2... 2 6 1 eee ee fopen(3S) 
frexp, ldexp, modf: split into mantissaand ......2... frexp(3) 
PPO Sil Ger t6- arses Gs Sees Wi Ses to? Sol a aks ere bh Ew eS from(1) 
front end for SCCS (Source Code Control Subsystem). scecs(1) 

fs, inode: format of file system volume. .........-. fs(S) 
fscanf, sscanf: formatted input conversion. . ........ scanf(3S) 
PSCK S585 8 as See eateries erate “et Se SS ei ee ee mklost+found(8) 
fsck: file system consistency check and interactive os 6 ee feck(8) 
fseek, ftell: reposition a file on alogicalunit. ........ fseek(3F) 
fseek, ftell, rewind: reposition a stream. .........-. fseek(3S) 
fsplit: split a multi-routine Fortran file into ....2.4.2.. fsplit(1) 
fstab: static information about filesystems. . ........ fstab(S) 
fstat: get file status. 2... 1 we te ee we we ws stat(2) 
fstat: get file status. 2... 2 ee ee ee ee ee ee stat(3F) 
fsync: synchronize a file’s in-core state withthat ...... fsync(2) 
ftell: reposition a file onalogicalunit .......2.4.. fseek(3F) 
ftell, rewind: repositionastream. ............ fseek(3S) 
ftime: get dateandtime. . . 2... 25 ee eee wee time(3C) 
ftp: ARPANET file transfer program. .........2.- ftp(1C) 
ftpd: DARPA Internet File Transfer Protocol server. Swe. fipd(8C) 
full-dupiex connection, . 2... 2... 5.6 ss « shutdown(2) 
full-screen remote loginto IBM VM/CMS. .... . ™3270(1) 
function, 656.0 os Bi ee a es So ee eS et en Igamma(3M) 
FUNCTIONS. 6-6: hoes ee aa Se cece, Bi a ene Ses asinh(3M) 
PUMCUIONE oe sos cel Gs 58 vee e eS ee cab we eS bit(3F) 
functions. . 2. 2 2 wwe ww we eww we ewe - erf(3M) 
functions. fabs, floor, ceil, rint: absolute .....2.2.2.. floor(3M) 
MUNCHIONS. 606 6 a ee ee ee wee aS es intro(3) 
FUNCTIONS. 65: fo es se ce fel Be, We a es ee we intro(3C) 
functions. 6.0: erie Sw es Sr wee et ok Ue BS we be SASS imtro(3F) 
PONCUIONG 2 a0 i 2h 6 6 eases ee. BS Sa dag ee intro(3M) 
functiOns:: 6. 6 i so ee: veh eee. eae eee intro(3N) 
TUNCHIONS.<.-:5. 5. Gene Wh ste I bee we A en bee intro(3X) 
functions. .. 2... ee ee AS en aE Re WE ee a j0GM) 
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math: introduction to mathematical library 
sinh, cosh, tanh: hyperbolic 

C06, tan, asin, acos, atan, atan2: trigonometric 
bessel 

curses: screen 

fread, 

adventure: an exploration 

backgammon: the 

battlestar: a tropical adventure 

hunt: a multi-player multi-terminal 
monop: Monopoly 

snake, snscore: display chase 

trek: trekkie 

worm: Play the growing worm 

canfield, cfscores: the solitaire card 
cribbage: the card 

hangman: Computer version of the 
boggle: play the 

chess: the 

zork: the 

wump: the 

igamma: log 

fmin, m_in, mout,/ madd, msub, mult, mdiv, pow, 


rand, srand: random number 

random, drandm, irandm: better random number 
lex: 

/srandom, initstate, setstate: better random number 
random number generator; routines for changing 
perror, 


from stream. 
stream. getc, 


getgid, 


variables. 

getuid, 

setfsent, endfsent: get file system descriptor/ 
setfsent, endfsent: get filesystem descriptor file/ 
system descriptor file entry. getfsent, getfsspec, 
filesystem descriptor file/ getfsent, getfsspec, 
endfsent: get file system descriptor/ getfsent, 
endfsent: get filesystem descriptor file/ getfsent, 
descriptor file/ getfsent, getfsspec, getfsfile, 
descriptor file/ getfsent, getfsspec, getfsfile, 
getuid, 


get group file entry. 
file entry. getgrent, 
getgrent, getgrgid, 


get network host entry. gethostbyname, 
sethostent, endhostent: get network host entry. 
host entry. gethostbyname, gethostbyaddr, 
current host. 

host. 

timer. 


get network entry. getnetent, 
entry. getnetent, getnetbyaddr, 
endnetent: get network entry. 


functions. ....... gf ae We Auge Gk en VoleSy Ar Ba epee math(3M) 
functions. .. 2... 2a ee ee ee te ae ee eee sinh(3M) 
functions and their inverses. sin, . .....-2.-02062 sin(3M) 
functions: of two kinds for integer orders. . ...-...- bessel(3F) 
functions with ‘‘optimal’’ cursormotion. ........-. curses(3X) 
fwrite: buffered binary input/output 2... 2 ee ee ee fread(3S) 
game. 2 ws we we eee a ee ee Be Sa he are adventure(6) 
game. 2 2. 6 ew ee beoieh. SoS: EP Ye) seis Hem, teh testes lentes @h vem backgammon(6) 
QAM. co Se ES Ste elie, of ee es : battlestar(6) 
Co a ae a ee a a a a oinieecPee tah e - « hunt(6) 
game. .. 2. ee ee . ea . ¢ +» monop(6) 
game. 6. 2 ewe ew ww we ew Pe er ey ee ee ae Se snake(6) 
game. .... oo abe ee eke oe Wik ee Ge is erie: THEK(G) 
game. 2... ee ee ee aiiae RS eae Sh Can er Tele ais worm(6) 
gamecanfield. . 2. 2.22 wee eee err eevee canfield(6) 
game cribbage, «1 0 1 1 1 1 ww ee ew ww ww of « ~6CTiDbage(6) 
gamehangman. ....... + 22+ ee © © © © © « hangman(6) 
game of boggle. ate 26. We be We Sa) eee é 2 DORRIES) 
game of chess. 2. 2 6 2 1 eee ee ee ee we ew ww + Chess(6) 
game of dungeon. . 2... 1 2 ee ee ee . + + + «zork(6) 
game of bunt-the-wumpus. . ee ee ee eae wump(6) 
gamma function. .. 2... 2 ee eee ee ee tees lgamma(3M) 
gcd, invert, rpow, msqrt, mcmp, move, min,omin, ..... mp(3X) 

PSE striae aig) tain ber sia! tors ans gcore(1) 
gcvt: output conversion. Pee ee er ee ecvt(3) 
generate a dump of the operating system’ sprofle ...... kgmon(8) 

: generate a fault. Bae, WSR ee Wi aR Ree RS Gs i abort(3) 
generate encryptionkey. 2. 2... 2. 2 6 ee ee ee eee makekey(8) 
generate hashed host table. 2... 2... 2 ee ee ee eee mkhosts(8) 
generate hashed passwordtable. . 2... 6 2 ee ee ee mkpasswd(8) 
generate lineprinter ripple patie. . .... 2.2.22 es Iptest(1) 
generate names fromi-numbers. . . 2... 6 ee 2 ee ee ncheck(8) 
generator, . 2. 2. 2 2 ee we ew 6s, We) ae at Yak as ase Se rand(3C) 
POENETSOR. 6h a ee ee Re random(3F) 
generator of lexical analysis programs. .......+... lex(1) 
generator; routines for changing generators. ........ random(3) 
generators. /srandom, initstate, setstate:betler ....... random(3) 
getror, iermo: get system errormessages. . ...-.-... perror(3F) 
getarg, iarge: return command line arguments. ....... getarg(3F) 
getc, fgetc: get a character fromalogicalunit, ....... getc(3F) 
getc, getchar, fgetc, getw: get characterorword ....... getc(3S) 
getchar, fgetc, getw: get characterorwordfrom ...... getc(3S) 
getcwd: get pathname of current working directory. ..... getcwd(3F) 
getdiskbyname: get disk description by itsname. ...... getdisk(3X) 

_ getdiskbyname: get disk description by itsmame. ...... getdiskb yname(3) 
getdtablesize: get descriptor table size. ......-..2.. getdtablesize(2) 
getegid: get group identity. . 2... 2... 2. eee ee ee getgid(2) 
getenv: get value of environment variables. .....2.2.. getenv(3F) 
getenv, setenv, unsetenv: manipulate environmental .... . getenv(3) 
geteuid: get useridentity,. 2... ...2-2-0-2- eee getuid(2) 
getfsent, getfsspec, getfsfile, getfstype, ........2.- getfsent(3) 
getfsent, getfsspec, getfsfile, getfstype, ......-2.2. getfsent(3X) 
getfsfile, getfstype, setfsent, endfsent: getfile ....... getfsent(3) 
getfsfile, petfstype, setfsent,endfsent: get .......2.. getfsent(3X) 
getfsspec, getfsfile, getfstype, setfsent, ........2.- getfsent(3) 
getfaspec, getfsfile, getfstype, setfsent, .........4. getfsent(3X) 
getfstype, setfsent, endfsent: get file system ........ getfsent(3) 
getfstype, setfsent, endfsent: get filesystem ........ getfsent(3X) 
getgid: get user or group IDofthe caller. ......... gewid(3F) 
getgid, getegid: get groupidentiy. ..........06. getgid(2) 
getgrent, getgrgid, getgrnam, setgrent,endgrent: .... . . getgrent(3) 
getgrgid, getgrnam, setgrent,endgrent:getgroup ...... getgrent(3) 
getgrnam, setgrent, endgrent: get groupfileentry, . ... . . getgrent(3) 
getgroups: get groupaccesslist. ........... . . getgroups(2) 
gethostbyaddr, gethostent, sethostent, endhostent: . ..... gethostbyname(3N) 
gethostbyname, gethostbyaddr, gethostent, ........ gethostbyname(3N) 

sethostent, endhostent: getnetwork ....... gethostbyname(3N) 

gethostid, sethostid: get/set unique identifierof ....... gethostid(2) 
gethostname, sethostname: get/setname Of current ..... gethostname(2) 
getitimer, setitimer: get/set value of interval ........ getitimer(2) 
getlog: get user’sloginname. .............-. getlog(3F) 
getlogin: get loginname. . 2... ......-..020200- getlogin(3) 
getnetbyaddr, getnetbyname, setnetent, endnetent: ...... getnetent(3N) 
getnetbyname, setnetent, endnetent: get network ...... getnetent(3N) 
getnetent, getnetbyaddr, getnetbyname, setnetent, ...... getnetent(3N) 
getopt: get option letter fromargv. ©... .....20. getopt(3) 
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getpid, 

scheduling priority. 

protocol entry. getprotoent, getprotobynumber, 
endprotoent: get protocol entry. getprotoent, 
setprotoent, endprotoent: get protocol entry. 


setpwfile: get password file entry. 
password file entry. getpwent, getpwuid, 
get password file entry. getpwent, 
resource consumption. 

utilization. 


entry. getservent, getservbyport, 
endservent: get service entry. getservent, 
setservent, endservent: get service entry. 
gettimeofday, settimeofday: 
gethostname, sethostname: 

getpriority, setpriority: 

gethostid, sethostid: 

getitimer, setitimer: 


sockets. 


ttys file entry. 
entry. getttyent, 


user shells. 
getc, getchar, fgetc, 


head: 
shutdown: close down the system at a 


time to ASCII. ctime, localtime, 
time, ctime, Itime, 

fish: play 

setimp, longjmp: non-local 


graph: draw a graph. 


gprof: display call 

plot: 

arc, move, cont, point, linemod, space, closepl: 
plot: 

1ib2648: subroutines for the HP 2648 
pattern. R 

vgrind: 

cherp: change 

getpgrp: get process 

killpg: send signal to a process 

killpg: terminate all members of a process 
setpgrp: set process 


getgrgid, getgrnam, setgrent, endgrent: get 


setregid: set real and effective 

setruid, setgid, setegid, setrgid: set user and 
getuid, getgid: get user or 

getgid, getegid: get 

groups: show 

chown: change owner and 

make: maintain program 
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getpagesize: get system page size. 2... 2 2 2 ee ee ee getpagesize(2) 
getpass: reada password. . 2... 6 ee eee ee ees getpass(3) 
getpeername: get name of connected peer. . 2. 2. - 2 ee getpeername(2) 
getpgrp: get process group. . 2. 2 6 eee ee ee te setpgrp(2) 
getpid: get processid. 2 6 we ee ee te ee ee ew getpid(3F) 
getpid, getppid: get process identification. oe 6 tte) es dees. Re getpid(2) 
getppid: get process identification. . 2... 2. eee ee getpid(2) 
getpriority, setpriority: get/set program... 2 ee ee ee getpriority(2) 
getprotobyname, setprotoent, endprotoent: get . . . .- getprotoent(3N) 
getprotobynumber, getprotobyname, setprotoent, ...... getprotoent(3N) 
getprotoeat, getprotobynumber, getprotobyname, ...... getprotoent(3N) 
getpw: get name fromuid. . 2... 2 2 0 eee ee tw getpw(3C) 
getpwent, getpwuid, getpwnam, setpwent, endpwent, .. . . getpwent(3) 
getpwnam, setpwent, endpwent, setpwfile: get... . 2 1s getpwent(3) 
getpwuid, getpwnam, setpwent, endpwent, setpwfile: .. . . getpwent(3) 
getriimit, setriimit: control maximum system ........ getriimit(2) 
getrusage: get information about resource... ...-.-- getrusage(2) 
gets, fgets: geta string fromastream. ........- +». gets(3S) 


getservbyname, setservent, endservent: get service .. . . . getservent(3N) 
getservbyport, getservbyname, setservent, . .... . . getservent(3N) 
getservent, getservbyport, tks das Bie es ie) Mas ret Be se getservent(3N) 
gevsetdateandtime. ..... 2 sees os lee at as 0 Se gettimeofday(2) 
get/set name of current host. tee: Lolcats ete: fare ene SiS e gethostname(2) 
get/set program scheduling priority, .. 2... 2. se. getpriority(2) 
get/set unique identifier of current host. 6 Re Sere et ee gethostid(2) 
get/set value of intervaltimer. . . 2. 2 2 2 2 ee ee eee getitimer(2) 
getsockname: get socketname. .. 2... 2-2 eee eee getsockname(2) 
getsockopt, setsockopt: get and setoptionson . . . . + ss getsockopi(2) 
gettable: get NIC format host tables fromahost. ...... gettable(8C) 
gettimeofday, settimeofday: get/set date andtime. ...... gettimeofday(2) 
getttyent, getttynam, setttyent, endttyent: get ........ getityent(3) 
getitynam, setttyent, endityent: get ttysfile ....2..2.. getttyent(3) 
getty: setterminal mode. . . 2. 2. 2. 2 2 2 2 ee ee eee getty(8) 
gettytab: terminal configuration database. . ........ gettytab(5) 
getuid, geteuid: get useridentity. 2... . 2.2.2.2. getuid(2) 
getuid, getgid: get user or group ID of the caller. ...... getuid(3F) 
getusershell, setusershell, endusershell: get legal . 2... . getusershel1(3) 
getw: get character or word from stream. ......-.--. getc(3S) 
getwd: get current working aciand ase Sager Bee) 48 getwd(3) 
give firstfewlines. . . 2... a Gebietes ewe head(1) 
PIVEN TIME). ee be We See See ae ee shutdown(8) 
glob: filename expand argument list. Be ee tas Oy ee SL ers esh(1) 
gmtime, asctime, timezone, tzset: convert dateand ..... ctime(3) 
gmtime: return sysiemtime. . . 2. 2... 22 eee eee time(3F) 
SSO PIR has, oe gE tw ee aes he aye ike ae gs AE ATS fish(6) 
BOO.) sak Tet tan Se eu Sea: ce oe fe WP ge Sn Vg wes setjmp(3) 
goto: command transfer. . 2... 2. 2 2s we ee ee eee esh(1) 
gprof: display call graph profiledata. .........24.. gprof(1) 
eae Se ee ee ee eee ace 4 ee praphOG) 

graph: drawagraphh ......2.. SP, nb 48? Si nS OS 8 graph(1G) 
graph profile data. 2... 1 1 ew we we ewe wwe gprof(1) 
graphics filters. 2... ee ee eee we www ene plot(1G) 
graphics interface. /erase, label, line, circle, ........ plot(3X) 
graphicsinterface. 6... 6 0 ew eee eee ese ot(5) 
graphicsterminal. . 2... 2 2 ee ee eee ewes 1ib2648(3X) 
grep, Regrep, fgrep:searchafilefora .......2.. grep(1) 
ee eee bie 0h ey bee ues tei 8! xe a ela vgrind(1) 
BTOUD. © se aioe Bie ee ee Se ee eS cherp(1) 
QOup. vw 6 ke we 6 8 OS ag Bs, Agee ahaa Sd a getperp(2) 
GQTOUD.: <s. oe Gashl. Bie os) eet ee) Ses WOR Ge ws killpg(2) 
BTOUP Sen ec on et te we Se a ee a ee es killpg(8) 
GROUP: aoe a a Gl a: eee oe ee ee ee © Setpgrp(2) 
group accesSlist. 2. 2 2 0 0 ee ee ee ee ew ww ew « getgroups(2) 
group accesslist. 2... 2 eee eee ee ew ew initgroups(3X) 
group accesslist. 2... 1. ee ee ee ee ws , setgroups(2) 
> groupfile, ..... OEE Ce ile cid ae ar ea group(5) 
group file entry. getgrent, . 2. 2. 2 2 eee wwe ee getgrent(3) 
group: groupfile. 2... 6 ee ee ee ee ew eee group(5) 
groupID. ..... 66 oI eat he ONE, “ec hee hgcwiia oe setregid(2) 
group ID. setuid, seteuid, Be i's la ee a ca a SR ow setuid(3) 
group(Dofthecaller. 2... 2 2 ee ee eee ww ene getuid(3F) 
group identity, 2... 6 ee ee ee ee we ew ww ene getgid(2) 
group memberships. - . Peer rae ar ar ae ey groups(1) 
group ofafile, 2... 1 ee ee ee ew ew ww ws chown(2) 
GTOUDS, © os a a Sree OR Scale, OE BG eh make(1) 

groups: show group memberships. . .........2.. groups(1) 
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worm: Play the growing wormgame. ... 1... 6 0 2 0 eee twee worm(6) 
stty, gtty: set and get terminal state (defunct). oss (antei deen se ney © stty(3C) 
stop: halt a job orprocess. . 2... ee we ete ew we te tw esh(1) 
reboot: reboot system or halt processor, . . 2... 6 2 ee ee ee ee eee ee reboot(2) 
; halt: stop the processor, 2. 6 6 we ee ee tt tte halt(8) 
rmail: handle remote mail received via wucp. 5. Morn eee. Atel ca eer we rmail(1) 
re_comp, re_exec: regularexpression handler, . 2. 2... ee ee eee eee eee eves regex(3) 
hangman: Computer version of the game hangman. .. . 2. 2.26 2 ee ee ee ee we eee hangman(6) 
hangman: Computer version of the game hangman. .... . hangman(6) 
vhangup: virtually ‘‘hangup”’ the current controlterminal. . .... ++. vhangup(2) 
nohup: run command immune to hangups. ... . ° ee ee ee ee ae ar ae ee csh(1) 
crash: what happens when the system crashes. Bisa Sey Ss fone aa el Ss “ete crash(8V) 
link: makea hardlinktoafile. 1... 2. es eee eee er eee link(2) 
intro: introduction to special files and hardware support. oe ae ee ee eC ee ee Te intro(4) 
rehash: recompute command hashtable. ...... eee ae oe ee a ee cesh(1) 
unhash: discard command hashtable. 2... 1 6 1 ee ee ee ee es - « esh(1) 
mkhosts: generate hashed hosttable. 2. 2. 2 1. 2 0 ee ee ee ee © e+ «6mkhosts(8) 
mkpasswd: generate hashed passwordtable. . 2... 6 + + 6 + + o © © © «© =mkpasswd(8) 
hashstat: print command hashing statistics. .. . a ee ee -'' (60) 
hashstat: print command hashing Statistics. . . . 2... .. csh(l) 
leave: remind you when you havetoleave. ..... one es her aya eset eee cee leave(1) 
od: file dump (octal, decimal, hex, ascii). . 2... 2. ee ee eee ee te tw od(1) 
hier: filesystem hierarchy, . 2. 2. 2. ee ee ee ee eee hier(7) 
ee ee nn ae oe . . hier(7) 
highpri: make the current process a high priority process. ee ae ee ee ee highpri(2) 
process. highpri: make the current process ahigh priority ...... highpri(2) 
history: print history eventlist. ....... b: Barve’ au Ve se) ann ee: Con's esh(1) 
history: print history event lis. 2. 2 2 2 ee ee ee ee cesh(1) 
hk: RK6-11/RK06 and RKO7 moving head disk ...... hk(4) 
fortune: print a random, hopefully interesting, adage. .......- ee er ae fortune(6) 
sethostid: get/set unique identifier of current host. gethostid, .. 2.2... 2 2 ee ee ee ee ewe gethostid(2) 
gethostname, sethostname: get/set name of current host. . 2... 2 2 ee we ee wee te we ee wwe gethostname(2) 
gettable: get NIC format host tables froma host. . ...... 2-2 - 8 a ew ee) as ee gettable(8C) 
hostnm: get name of current host. 2... 6 1 we ee ee we ww ee ee wee es hostnm(3F) 
uusend: send a file toaremote host. 2... 0 2 eee ww ee we ee we tw ee we we uusend(1C) 
htonl, htons, ntohl, ntohs: convert values between host and saved byteorder, 2... 1 ewe ee ee we we byteorder(3N) 
L.sys: UUCP remote host description file. 6 2. 2. 2 ee ee ee ee ee ee es L.sys(5) 
remote: remote host description file, 2... 2 2 eee ee ee ee es remote(5) 
gethostent, sethostent, endhostent: get network host entry. gethostbyname, gethostbyaddr, ee eee gethostbyname(3N) 
hosts: host name database. 2... 1 1 we ee ew ee ee hosts(5) 
phones: remote host phone number database. .. 2... 2-2 + 2 ee eee phones(5) 
ruptime: show host status oflocal machines. . . 2... 2. 0 ee ee eee ruptime(1C) 
hostid: set or print identifier of current hostsystem. . 2. 2. 2 6 ee ee ee ee ee ee ene hostid(1) 
hostname: set or print name of current host system. ... . ie: iat e Gua e Ge ete. & hostname(1) 
mkhosts: generate hashed hosttable. 2... 2 2 2 eee eee ee we ee mkhosts(8) 
htable: convert NIC standard format hosttables. 2... 22 2 eee wwe te we we ee ene htable(8) 
gettable: get NIC format hosttablesfromahost . 2... ....2.20 5022 eee gettable(8C) 
system. hostid: set or print identifier of currenthost ......4.. hostid(1) 
Laliases: UUCP hostname aliasfile . 2... 2... 1 ewe ewe even L.aliases(5) 
hostname: set or print name of current host system. .... . hostname(1) 
hostnm: get name of currenthost. .......-.2008-. hostnm(3F) 
ping: send ICMP ECHO_REQUEST packets to network hosts. ...... t-te a tara sis ta sg See eG ping(8) 
uuname: list names of UUCP hosts. 2... 1 6 ee we eee wwe te we et ww uuname(1C) 
hosts: host name database. 2... 1 6 0 ew we we eww hosts(5) 
uptime: show how long systemhasbeenup. . . . 2... + ee ee eee uptime(1) 
1ib2648: subroutines forthe HP 2648 graphicsterminal. ... 2... 2.2. 2 2 ee eee 1ib2648(3X) 
hp: disk interface, 2. 0 2 0 es ee ct we ee es hp(4) 
htable: convert NIC standard format host tables. ...... htabie(8) 
host and network byte order. htonl, htons, ntohl, ntohs: convert values between ...... byteorder(3N) 
and network byte order. htonl, htons, ntohl, ntohs: convert values betweenhost ...... byteorder(3N) 
hunt: a multi-player multi-terminal game. . . ...... . hunt(6) 
wump: the game of hunt-the-wumpus. 2... 2. 2 6 ee ee ee te ee wump(6) 
asinh, acosh, atanh: inverse hyperbolic functions. oa Oa Ay attendees es asinh(3M) 
sinh, cosh, tanh: hyperbolicfunctions. ... 1... 2-2 ee ee . « . sinh(3M) 
value. hypot, cabs: Euclidean distance, complex absolute ..... hypot(3M) 
vacation: return ‘‘I am on vacation’ message. . .. 2... 2. 2 2 ee eee vacation(1) 
getarg, iargc: return command line arguments. ........2.. getarg(3F) 
mset: retrieve ASCII to IBM3270 keyboard map. .... 2.2.1.2 2 ee wees mset(1) 
map3270: database for mapping ascii keystrokes into IBM3270 keys. 2... 2 ee ee ee ee ee we ew we map3270(5) 
tn3270: full-screen remote loginto IBMVM/CMS. ..... 2.222 eee ee ee eee 1n3270(1) 
icheck: file system storage consistency check, .. ... . . icheck(8) 
ping: send ICMP ECHO REQUEST packets to network hosts. ..... ping(8) 
getpid: get process id, 6 ww we ee et ee eee ew ew te we getpid(3F) 
setregid: set real and effective group ID. . 2... 2 2 ee ee ee eee ee ww wen ne setregid(2) 
setgid, setegid, setrgid: set user and group ID. setuid, seteuid, setruid, ............2.64.. setuid(3) 
whoami: print effective current user id. Be OR Gale Wetec Cah Weir le ter cete Srcie ier Zo, Wee oe lw Te cele ele Set, ee 102 whoami(1) 
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getuid, getgid: get useror group IDofthecaller. ..... gig tas Stata. cas cele, ck wen ele 6 getuid(3F) 
su: substitute user idtemporarily. . 2... 2 2 ew ee ee tee es su(1) 
form. idate, itime: return date or time in numerical . . . 1... . idate(3F) 
getpid, getppid: get process identification, . .. 1... 2 ee eee ee ee eee getpid(2) 
gethostid, sethostid: get/set unique identifier of current host. fiber car des ita an tal Sousa apenas e gethostid(2) 
hostid: set or print identifier of current host system. .......-+-- - - . « hostid(1) 
getgid, getegid: get group identity. .... 2... 2 ee eee Boe ecve ial tats ay tere getgid(2) 
getuid, geteuid: getuser identity, 2... 2. 2 2 we ewe ee we ee te ew getuid(2) 
setreuid: set real and effective user ID’s. Bese Sar et ee Se @ dc ee W216, Gis Saocee eae 8 setreuid(2) 
perror, gerror, iermo: get system error messages. . 2. 2 2 os eo 6 © + © ~6perror(3F) 
if: conditional statement. . 2... 6 2 0 ee tw ew we es esh(1) 
biff: be notified if mail arrives and who it is from. Sia ek bee 8 . . . biff(1) 
eval, exec, exit, export, login,’ sh, for, case, if, while, :, .,break,continue,cd, ...... +222 - sh(1) 
ifconfig: configure network interface parameters. ee aoe ifconfig(8C) 
unifdef: remove ifdef’ed lines. . . . GES ine eb er ei unifdef(1) 
il: Interian 10 Mb/s Ethemet controller. aie ae ta da, che es il(4) 
core: format of memory imagefile. . 2... 2. 2 2 ee eee eee ee oe « COS) 
gcore: get core images of running processes... 0... 0... 0 es + geore(l) 
notify: request immediate notification .. 2... 2.56 eee ee 6 © « COA) 
nohup: run command immune to hangups. : eee we a ec ee ee eo. BA) 
implog: IMP log interpreter. . 2 2 2 2 2 0 ee te ee ee implog(8C) 
implogd: IMP logger process). ...... Chelle Ser aie i implogd(8C) 
xstr: extract strings from C programs to implement sharedstrings, .... 2... ee ee xstr(1) 
implog: IMP log interpreter, 2. 2. 2 2 ee ee ee ee implog(8C) 
implogd: IMP logger process. . . . 2 2. 2 2 ee ee ee implogd(8C) 
nw: Integrated Solutions, Inc., 10 Mb/s Ethernet controller, . .....--..0200- nw(4i) 
which: locate a program file including aliases and paths (c s h only). ......-+.. which(1) 
fsync: synchronize a file’s in-core state with thatondisk, .. 2... 2.56 + eee ee fsync(2) 
dump, dumpdates: incremental dumpformat. .... 2... 2 ee ese ee dump(5) 
dump: incremental file system dump. ......-+++s-e+e- dump(8) 
restore: incremental file system restore. . 2. 2. 2 2 2 0 2 eee ee restore(8) 
indent: indent and format C program source. ... 2... 5+... indent(1) 
indent: indent and format C program source. . ......- indent(1) 
tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation routines. tgetent, ......-.. termcap(3X) 
pex: permuted index, 6... 2. ee ee ee eee te we te et es (1) 
L-dialcodes: UUCP phone number indexfile. 2. 2 2 2 1 we ee ee ee et ee ee we L-dialcodes(5) 
bibliography. indxbib, lookbib: build inverted index for a bibliography, find references i ENR 2S .'0> et es 6 Ge lookbib(1) 
Objects. index, rindex, Inbink, len: tell about character ....... index(3F) 
strncat, strcmp, strncmp, strcpy, strncpy, strien, index, rindex: string operations. strceat, . . 2... 1 6 es string(3) 
last: indicate last logins of users and teletypes. . .....-+.-- last(1) 
syscall: indirectsystemcall, ....... aut, god Biss ade fete syscall(2) 
fsplit: split a multi-routine Fortran file into individual files. .........406e-. bs ecisa, tam 28 Fe fsplit(1) 
bibliography, find references in a bibliography. indxbib, lookbib: build inverted index TORR! oe eB ete: 8, oe lookbib(1) 
inet: Internet protocol family. . . 2... 2. 2. ee we ee inet(4F) 
inet_Inaof, inet_netof: Internet address/ inet_addr, inet_network, inet_ntoa, inet makeaddr, ..... inet(3N) 
inetd: internet “‘super—server’’. Scr ie a) asc ce an Jae We inetd(8) 
inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_Inaof, inet_netof: Internet address/ . . 2.2... 6 -. inet(3N) 
address/ inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_Inaof, inet_netof:Intemet ....... inet(3N) 
/inet_network, inet_ntoa, inet | makeaddr, inet_ ‘Inaof, inet_netof: Internet address manipulation routines. ..... inet(3N) 
inet_| netof: Internet address/ inet addr, inet_network, inet_ntoa, inet_makeaddr,inet_Inaof, ..... inet(3N) 
Internet address/ inet_addr, inet_network, inet_ntoa, inet | makeaddr, inet_| Inaof,inet_netof; ...... inet(3N) 
on a VAX (temporary). infnan: signals invalid floating-point operations ..... .. infnan(3M) 
bad144: read/write dec standard 144 bad sector information. ..... PRC eee ee eee oe bad144(8) 
dbx: dbx symbol table information. as pe tet-p Nene e: to). Me" athe ene eee Wek Ue Se dbx(5) 
dumpfs: dump file system information. ....... BSG a Tae oes ae Wy Be ei Khoa dumpfs(8) 
pac: printer/plotter accounting information. . . .. 2.2. 2 eee ee eee ee ee oe pac(8) 
chfn, chsh, passwd: change password file information. . .......6.2.266-. ne ee ee ee passwd(1) 
tzfile: time zone information. . . 2... 0. 2 ee ee ee we ee ww ews tzfile(5) 
fstab: static information about filesystems. . . 2.2... 2.6 2 ee ee fstab(5) 
getrusage: get information about resource utilization. .......4... getrusage(2) 
vtimes: get information about resource utilization. ..... =... . . vtimes(3C) 
man: find manual information by keywords; print out the manual. Nop, 1s Oe wh 16 man(1) 
finger: user information lookup program. ......... 2.2... . finger(1) 
miscellaneous: miscellaneous useful information pages. . 2... 6 2 ee ee ee ee eee intro(7) 
XNSrouted: NS Routing Information Protocoldaemon. ......-+.+.+..44.-. XNSrouted(8C) 
fingerd: remote user information server. . . . eee ee ee ee fingerd(8C) 
init: process control initialization. Oi ont O. Coles tenes ten ea init(8) 
initgroups: initialize group accesslist .. ... o . initgroups(3X) 
init: process control initialization, . 2. 2. 6 6 ee ee ee eee ww es init(8) 
joinit: change {77 /O initialization, . 2... 6 6 ee ee ee ee ew we ns ioinit(3F) 
tset: terminal dependent initialization. ...... ae ee ee ee oe ee tset(1) 
ttys: terminal initialization data. 2 2. 6 6 6 ee eee ee ww ew ns ttys(S) 
initgroups: initialize groupaccesslist. «6 6 6 eee eee ee es initgroups(3X) 
connect: initiate a connection onasocket. ....... . . connect(2) 
popen, pclose: initiate /Oto/froma process. .. 2.6.2.5 eee eae popen(3) 
generator; routines for changing/ random, srandom, _initstate, setstate: betterrandom number .......... random(3) 
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fimin, fimax, ffrac, dfimin, dflmax, dffrac, inmax: return extreme values. . 2. 2 2 0 2 0 ee wees fiminGF) 
Clri: clear i-mode. 2. 2 2 wee ewww te ee we tw tte clri(8) 
fs, inode: format of file system volume. bi at Sh ee SR aes we, Ugh Ge fs(5) 
read, readv:read input ....... > Cacti oar ae te a at nee ve car See der read(2) 
soelim: eliminate .so’s from mroff input. 2... 2. 6 ee we ee we et te wt es soelim(1) 
scanf, fscanf, sscanf: formatted input conversion. . go Bical sas te av es cel Te vie a scanf(3S) 
ungetc: push characterback into inputstreaam. . 2... 22 2 ee eee ee ee ene ungetc(3S) 
fread, fwrite: buffered binary input/output. ..... Pisa) Ride e, Say Se Sok es Be fread(3S) 
stdio: standard buffered input/output package. . 2... 2 2 ee ee eee eee antro(3S) 
stdio: standard buffered input/output package. 2... 2 eee eee rae Bidio(3S) 
ferror, feof, clearerr, fileno: stream status inquiries. . . 2... 2. 2 2 ee eee eee et ferror(3S) 
refer: find and insert literature references in documents. ......-+e-. refer(1) 
insque, remque: insert/remove element fromaqueve. ..... +--+ es insque(3) 
insque, remque: insert/remove element from a queue. insque(3) 
install: install binaries. 2. 2... 2 2 0 ee ee wee ee eee install(1) 
install: install binaries. SiseG igh ie ad co. ate, coset we? coe GOES a instal}(1) 
learn: computer aided instruction about UNIX. . 2... 2 2 6 ee ee ees learn(1) 
controller. nw: Integrated Solutions, Inc., 10 Mb/s Ethernet .......-- nw(4i) 
cp: Intelligent Communications Processor. .. 1. +s se ee cp(4i) 
doctor: interact with a psychoanalyst. eS a A ee Grae doctor(6) 
fsck: file system consistency check and interactive repair, . 2. 2 2 6 ee eee ee eee . fisck(8) 
fortune: print a random, hopefully interesting, adage. . 2. 2. 2 2 2 eee ee we ee ee fortune(6) 
el Gisk: MONTAGE. 36.6 6 66) oe ee Se ee el(4) 
hp: disk interface. 2. 2. 2 2 ew eee eee eee : hp(4) 
lo: software loopback network interface. . . ... ee ee ee oe Sa we es 10(4) 
mtio: UNIX magtape interface. 2... 6 2 0 ee ee ee te tte ee es mtio(4) 
cont, point, linemod, space, closepl: graphics interface. /erase, label, line, circle, arc, move, 5 plot(3X) 
plot: graphics interface. 2... 1. 1 ee ee ee te ee th te he ws plot(S) 
rm: DEC RX02 floppy disk interface. . 2... 2... 2 eee eee eee eevee 1™(4) 
sd: VME SCSI disk adaptor interface. . 2. 1 1 1 6 ec eee we we we ee es sd(4) 
sm: VME SMD disk interface. . .....6. Sud) Sule, Sheree e: eer Gs. m4) 
tm: TM-11/TE-10 magtape interface, 2. 1 1 1 we ee ee te ew we we te ws tm(4) 
ts: TS-1] magtape interface, 2. 6 1 1 1 ww eee ew ew ew ww ww 1s(4) 
tty: general terminal interface. . 2... 1 1 ee we ee ee ew we ewww s tty(4) 
ifconfig: configure network interface parameters. . 2... 62 2 ee ee ew ee ee ifconfig(8C) 
plot: openpl et al.: £77 library interfaceto p | o t (3X) libraries. 2... 2... ww ee plot(3F) 
telnet: user interface tothe TELNET protocol. .... 2... + ew ee telnet(1C) 
slattach: attach serial lines as network interfaces. . 2... 2.200. se ee ew ew we © © Bhattach(8C) 
il: Interlan 10 Mb/s Ethernet controller. . . . 1... «+... i(4) 
swapon: add a swap device for interleaved paging/swapping. ......-.-+.e- + + - swapon(2) 
sendmail: send mail overthe internet. . 2... 2 ee ee we eee we wee eee ae sendmail(8) 
/inet_ntoa, inet_makeaddr, inet_Inaof, inet_netof: Internet address manipulation routines. . 5.0... 0s. inet(3N) 
named: Internet domain name server. .. 2. 2... 1.5 2 eee ee named(8) 
named: Internet domain name server, . .. 1... eee ‘ - named(8C) 
ftpd: DARPA Internet File Transfer Protocol server, .. 2... 2.24. ftpd(8C) 
ip: Internet Protocol. . 2... 6 2 ee ee we ee wee ip(4P) 
inet: Internet protocolfamily. . 2... 2... eee eevee inet(4F) 
inetd: internet ‘‘super-server’. . 2... 2 2 ee ew ee ee inetd(8) 
tcp: Internet Transmission Contro] Protocol. ....... s+. tep(4P) 
whois: DARPA Internet user name directory service. . . 2... 6 2 ee ee whois(1) 
spline: interpolate smooth curve. be ee at es ae: eee Ered spline(1G) 
implog: IMP log interpreter, 2. 2. 2. 6 2 ee ew eee wee we we es implog(8C) 
lisp: lisp imterpreter, 2. 2 2 6 2 ee eee ee we ee wee noe lisp(1) 
uuxqt: UUCP execution file interpreter, 2. 6 6 6 ee ewe ee we ee ee + » uuxqt(8C) 
csh: a shell (command interpreter) with C-like syntax, ...... Bette nos Ms esh(1) 
pipe: create an interprocess communication channel. . ........--, pipe(2) 
atomically release blocked signals and wait for interrupt. sigpause: . . .. 2... 22 be SSP cor 8S sigpause(2) 
siginterrupt: allow signals to interrupt systemcalls. . 2... 6. 2 2 ee ee ee wes siginterrupt(3) 
onintr: process interrupts in command scripts. .. 2... ee eee ee esh(1) 
intro— introduction to network library functions. ...... intro(3N) 
intro: introduction to commands. ...... +2. s.e sees intro(1) 
intro: introduction to compatibility library functions. ....... intro(3C) 
intro: introduction to FORTRAN library functions. ......2.. intro(3F) 
intro: introduction to library functions. .......-.080.4 intro(3) 
intro: introduction to mathematical library functions. ....... intro(3M) 
math: introduction to mathematical library functions. ....... math(3M) 
intro: introduction to miscellaneous library functions. ....... intro(3X) 
intro— introduction to network library functions. ....... =... intro(3N) 
networking: introduction to networking facilities. . ........220. intro(4N) 
intro: introduction to special files and hardware support. ...... intro(4) 
intro: introduction to system calls anderrornumbers. ....... intro(2) 
commands. intro: introduction to system maintenance and operation ...... intro(8) 
check: generate names from i-numbers. . . 1... 2-26.26 Se ee Ae eS ncheck(8) 
(temporary). infnan: signals invalid floating-point operationsona VAX ........ infnan(3M) 
asinh, acosh, atanh: inverse hyperbolicfunctions. .........=... =. . asinh(3M) 
atan, atan2: trigonometric functions and their inverses. sin, cos, tan, asin, acOSs, ...... 2... eee sin(3M) 
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m_in, mout,// madd, msub, mult, mdiv, pow, gcd, 
in a bibliography. indxbib, lookbib: build 

tread, twrite, trewin, tskipf, tstate: {77 tape 

ioinit: change {77 

select: synchronous 

iostat: report 

popen, pclose: initiate 


rand, drand, 

random, drandm, 

sail: multi-user wooden ships and 

isalpha, i isupper, islower, isdigit, isxdigit, 
isalnum, isspace, ispunct, isprint, isgraph,/ 
/isspace, ispunct, isprint, isgraph, iscntrl, 
tynam, 

ttyname, 

Asalnum, isspace, ispunct, isprint, isgraph, 
isprint, isgraph,’ isalpha, isupper, islower, 
/isxdigit, isalnum, isspace, ispunct, isprint, 
ispunct, isprint, isgraph, isalpha, isupper, 
Asdigit, isxdigit, isalnum, isspace, ispunct, 
Aislower, isdigit, isxdigit, isalnum, isspace, 
/isupper, islower, isdigit, isxdigit, isalnum, 
system: 

isspace, ispunct, isprint, isgraph,/ isalpha, 
isgraph,/ isalpha, isupper, islower, isdigit, 
idate, 

omin, fmin, m_in, mout, omout, fmout, m_out, sdiv, 


jobs: print current 
stop: halt a 

kill: kill 

Iprm: remove 


atrm: remove 
atq: print the queue of 


R msgs: system messages and 
makekey: generate encryption 
mset: retrieve ASCII to IBM 3270 
database for mapping ascii keystrokes into IBM 3270 
map3270: database for mapping ascii 
apropos: locate commands by 
man: find manual information by 
profile buffers. 
kill: 


bessel functions: of two 


mem, 
linemod, space, closepl:/ plot: openpl, erase, 


awk: pattern scanning and processing 

be: arbitrary-precision arithmetic 

efi: Extended Fortran 

set, shift, times, trap, umask, wait: command 
vgrindefs: vgrind’s 

order. 


frexp, 
leave: remind you when you have to 
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invert, rpow, msqrt, mcmp, move, min, omin,fmin, .... - mp(3X) 
inverted index for a ee: find references ...... lookbib(1) 
VO. topen, tclose, . .. atric 'e: Gk nel Meee Se fan Oh topen(3F) 
VO initialization, ©. 2... 1 1 ee et ee et ttt ioinit(3F) 
VO multiplexing, © 2 2 2 ee es select(2) 
VO statistics. 2. ...... a ar ae eee ae ee iostat(1) 
V/O to/from a Si eincerciot eas ates feria Pia: cas Sadie, as popen(3) 
ioctl: control device. ..... SP oee he poe ee ewe eS ioctl(2) 
joinit: change f77 V/O initialization, . 2... 6+ es ee ee ioinit(3F) 
jostat: report I/O statistics. 2 2 2 1. 2 ee eee ee ew jostat(1) 
ip: Intemnet Protocol, 2 2 2 2 ee ee ee ee we wwe ip(4P) 
irand: return random values. bie Clay er yy tel et ee se gees oe rand(3F) 
irandm: better random number generator. .... +--+. random(3F) 
iron men. . 2. 1 ee ee ew ee es oN oo lense Mes eh @ Slee sail(6) 
isalnum, isspace, ispunct, isprint, isgraph/ ....---.-- ctype(3) 
isalpha, isupper, islower, isdigit, isxdigit, .....+-+... ctype(3) 
isascii, toupper, tolower, toascii: character/  . . 2 - +s - ctype(3) 
isatty: find name of aterminal port. ... +. + 2+ +> ttynam(3F) 
isatty, ttyslot: find name of aterminal, .......-.-. ttyname(3) 
iscntri, isascii, toupper, tolower, toascii/ . . 2... +. 6s ctype(3) 
isdigit, isxdigit, isalnum, i isspace,ispunct, ... +. -. +++. ctype(3) 
isgraph, iscntri, isascii, toupper,tolower,// ..... . : ctype(3) 
islower, isdigit, isxdigit, isalnum, isspace, ......... ctype(3) 
isprint, isgraph, iecntri, isascii,toupper/  ... +--+... ctype(3) 
ispunct, isprint, isgraph, iscntrl,isascii/ ..... 2... ctype(3) 
isspace, ispunct, isprint, isgraph, iscntrlj . 2... 2 ee ee ctype(3) 
issue ashell command. ..... 2. se eee cece system(3) 
isupper, islower, isdigit, isxdigit, isalnum, aig Gee ce ee ecw ctype(3) 
isxdigit, isalnum, isspace, ispunct, isprint, ......... ctype(3) 
itime: retum date or time in numericalform. ........ idate(3F) 
itom: multiple precision integer arithmetic. /min, ...... mp(3X) 
50, jl, jn, yO, yl, yn: bessel functions.  ......-22.2.. j0G3M) 
jl, jn, yO, yl, yn: bessel functions. . 2... 1. ee ee ee j0(3M) 
jn, yO, yl, yn: bessel functions. . . . 1... 2 2 2 2 ee oe jO(3M) 
jobinbackground. . 2... 1 2 ee ew ee ee te ew esh(1) 
job into foreground. era) Tee oieat gy ver Se oie Of eS esh(1) 
AMR ke nie eos oe Wogan es Scan aR Lak ea tg esh(1) 
job or process. 2 2 2 1 we ee eee : ee esh(1) 
jobs and processes. 2. 2. 6 2 ee ee ee ee es - . - ¢sh(1) 
jobs from the line printer spooling queue. ......... Iprm(1) 
jobs: print current job list. 2 6 6 6 1 ee ee ee ew ee CBHI) 
jobs spooled by at. ww ww we ee te atrm(1) 
jobs waiting to be run. ROG ote oe ee te, Bate ela aE 
join: relational database operator. ....... se 6 « « join(l) 
junk mail program. . . 1... 2.2... . +e 6 ee «6msgs(1) 
ROY. oO o> oor ec kicss OR Wee ee ee, Os ieee oes makekey(8) 
keyboard map. . 2. 2. 2 6 2 ee eee ew we ew ee we mset(1) 
keys. map3270: «1 1 2 es wee we we we we ew ewe map3270(5) 
keystrokes into IBM 3270 keys. . 2. 2... 2. 2 2 we eee map3270(5) 
keyword lookup. 2... 6 6 2 ee eee ee ee www apropos(1) 
keywords; print out the manual. . 2... 2... 6 ee eee man(1) 
kgmon: generate a — of the operating system’s  ..... kgmon(8) 
kill jobs and processes. 2. ....-00. Bikini sah id csh(1) 
kill: kill jobs and processes. Sitar tay Lie, ceweimie® jase ter So-aet Khe esh(1) 
kill: senda signaltoa process. 2. 2. 2. 6 2 ee ee ee we kill(3F) 
kill: send signal toa process. 2... 2 2 2 eee ee wee kill(2) 
kill: terminate a process with extreme prejudice. ...... hall(1) 
killpg: send signal toa process group. .........5 killpg(2) 
killpg: terminate all members of a process group. ...... killpg(8) 
kinds forintegerorders. . . 1. 2... 2 ee eee eees bessel(3F) 
kmem, vmem: main memory. ... 2... 2.2 ee eee mem(4) 
label, line, circle, arc, move, cont, point, .......40. plot(3X) 
L.aliases: UUCP hostname alias file. . .......2.6. . Laaliases(5) 
language. . 2... 2... Sila ‘Suate: san el os vette, xB “es Jue awk(1) 
language. ..... Ee a a ee eee ee be(1) 
Language: 6 es aca ce 8 a eee a we oe eS efi(1) 
language. lexit, export, login, read, peed oe 'ey eertey (ote sh(1) 
language definition database. .. . ao 16s Biniel de- ee vgrindefs(5) 
lastcomm: show last commands executed i inreverse ..... lastcomm(1) 
L.cmds: UUCP remote command permissions file. .... L.cmds(5) 
Id: linkeditor, 2... 1 2 we we ee aie Galan Giirat ag Id(1) 
L-devices: UUCP device descriptionfile. .......4.. L-devices(5) 
Idexp, modf: split into mantissa and exponent. ....... frexp(3) 
L-dialcodes: UUCP phone number index file. ....... L-dialcodes(5) 
learn: computer aided instruction about UNIX. ....... learn(1) 
VOAVE sso ess, BI Na se? 00 0 We Me eS Hire Se leave(1) 
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leave: remind you when you havetoleave. ......-- leave(1) 
exit: leaveshell, . ..... Seco @ o> awe ee ee ee esh(1) 
getusershell, setusershell, endusershell: get legal usershells. 2... 2. 1 1 ee et ee ee + « « getusershell() 
index, rindex, Inblnk, len: tell about character objects. . ........- ees ec index (3F) 
truncate: truncate a file toa specified length, . 2... 2 2 ee eee eee eee tenes truncate(2) 
getopt: get option letterfromargv. ..... 2... eee eee ee eee getopt(3) 
lex: generator of lexical analysis programs. ...+..-- lex(1) 
lex: generator of lexical analysis programs. . . . 2... 2 ee ee ee ee lex(1) 
Igamma: log gamma functionn ..... 2-2 ee eee lgamma(3M) 
terminal. 1ib2648: subroutines for the HP 2648 graphics .... . ~ - 1ib2648(3X) 
et al.: £77 library interface to p 1 o t (3X) libraries. plot:openpl .. 2... 2.2.2 2 ee ee ee plot(3F) 
ranlib: convert archivestorandom libraries. . 2... 0 1 ee ee ee wee we tw ew wns ranlib(1) 
lorder: find ordering relation for an object library. . .... G fel eievve ie Wyse wiser vaese! < + « « + Jonder(1) 
ar: archive (ibrary) fileformat. . 2... 6 ee we we tw we ww ar(5) 
intro: introduction to library functions. ei Bore wes 1S 2s y anes. es ere Oe as ee intro(3) 
intro: introduction to compatibility library functions. ......... bs er epee eee TS - intro(C) 
intro: introduction to FORTRAN library functions. . .... a as ee Scie fees ie ay ed intro(3F) 
intro: introduction to mathematical library functions. . . 2... 2. 20 ee ee ee ee ee intro(3M) 
intro— introduction to network libraryfunctions. ......... pianist cel owe at wT pte eee intro(3N) 
intro: introduction to miscellaneous library functions. . Sse. cae ve. al Terie ee Te ce - . intro(3X) 
math: introduction to mathematical libraryfunctions. . . 2... 6 0 5 see ew ee wee math(3M) 
plot: openpl et al.:f77 library interface to P 1 ° t (3X) libraries. 2. 2... 2. 2s plot(3F) 
ar: archive and library maintainer, 2. 2... 2.2 6 ee eee ew ewe ar(1) 
limit: sce a sane era meme ok Sait aise Wi cesh(1) 
limit: alter per-process resource limitations. ...... Goes SG eile ee er, geneue, ob cesh(1) 
unlimit: remove resource limitiations . . 1... 66 ee ee wee eee eens esh(1) 
quota: display disk usage and limits. . ......... Sa del nw an Ser As quota(1) 
getarg, iargc: return command line arguments. . . a dioica Sie at cattet le? “eros Soman tate 
space, Closepl:/ plot: openpl, erase, label, line, circle, arc, move, cont, point, linemod, .....eee-e piot(3X) 
(obsolete). bk: line discipline for machine-machine communication .... . bk(4) 
col: filter reverse linefeeds.§ . . 2... 2+ ea as gneieie ie: el athe eos col(1) 
sysline: display system status on status lineofaterminal . . 2... 2. 2 eee eee eee we sysline(1) 
Ipe? Off Line pript:.5 6 i ye ee a we ee a ee ae Ipr(1) 
Ip: line printer, 2 2. 1. 2 we wwe ee ee we ee we ew wn Ip(4) 
Ipc: line printercontrol program. . 2... 6 ee eee eee Ipe(8) 
Ipd: line printerdaemon. ...... ++ se eee . Ipd(8) 
Iprm: remove jobs from the line printer spooling queue. . . 2. 6 2 eee ee ee ee Iprm(1) 
/erase, label, line, circle, arc, move, cont, point, linemod, space, closepl: graphics interface. ...... . . plot(3X) 
Iptest: generate lineprinter ripple pattern. . . 2. 2 2 6 6 ee © ee oe e © Iptest(l) 
head: give firstfew lines. 2 2. 2 6 ee ee eee eee wwe + 6 + « ~head(l) 
unifdef: remove ifdef'ed lines. 1. 2. 1... 2. 0 eee eee eee ee we wee aes unifdef(1) 
slattach: attach serial lines as network interfaces. . . . 1. 2... + 5 es « + « Slattach(8C) 
comm: select or reject lines common to two sorted files. ee ee we oe ew ee COMM|]) 
fold: fold long lines for finite width output device. 8. 2... 2 ee ee foid(1) 
uniq: report repeated linesinafile. ......... tye ead, eee ee uniq(1) 
look: find linesinasortedlist. 1... 2... ee ee ee eevee look(1) 
rev: reverse linesofafile. . 2... 6. 2 ee eee eee ween rev(1) 
readlink: read value ofa symbolic link, . 2... 2 2 eee ee ew ee Stes Fal ah Se 6s Byers readlink(2) 
Ad): ‘TNE OGitOF: ae ase fe cas WS a er we Rie Sea a BA Id(1) 
a.out: assembler and link editoroutput . 2... 2 2 6 2 ee we we www a.out(S) 
link: make ahardlinktoafile. ... 1.2... 562 ee ee link(2) 
link: make a link to an existing file. oer la Bs BOG Ree link(3F) 
link: makeahard linktoafile. . 2... we eee eee eee ee eee link(2) 
symlink: make symbolic linktoafile, 2... 2. 2 eee eee eee ween symilink(2) 
link: make a link toanexistingfile. . 2... 2... 2 2 ee eee eee link(3F) 
In: make links, 2... ee ee ee eee nee eww we ee in(1) 
lint: aC program verifier, 2... 2. ee wee ee eee lint(1) 
Ixref: lisp cross reference program. ... 2... 2 see eee Ixref(1) 
lisp: lispinterpreter, 2. 2. 2. 2 eee ee ee ee we ee lisp(1) 
lisp: lisp interpreter. ee ee ee ee ee « « lisp(1) 
liszt: compile a Franz Lisp program. ... 2... 2 1 2 eee we ee ee ene liszt(1) 
troff. vip: Format ria aes sas with nroff, vtroff,or ...... viptl) 
glob: filename expand argument li Oe a er ee a a ee ee ee ee a cesh(1) 
history: print history event list ge OS a oe ges Reet a a a ae ee er Sea ee esh(1) 
jobs: print current job list 2. 2 2 2 we ee ee Se ee ae es ee ee cesh(1) 
shift: manipulate argument list. 2 6 6 6 ee ee eee ee te ht ewe ewes cesh(1) 
getgroups: get group access list. 2. 2 6 2 ee ee eee es oo Whe Bae . getgroups(2) 
initgroups: initialize group access list. 2. 2 6 6 ee eee te ee ee ee we ew initgroups(3X) 
look: find linesinasorted list 2. 6 1 1 we wee ee ee te we tt we we ew look(1) 
nlist: get entries from mame list. 2... 1 2 ee eee ee te tt te tw ee es nlist(3) 
nm: printname list. . 2... . 2-2 e ae a ee eae ee eee ee nm(1) 
setgroups: set group access list. © 2 2 2 2 ee ee ee ee eee eee ew we setgroups(2) 
symorder: rearrange name list . 2... 2-6. Breet ee Mee with, cote Avan ef," ¢ he: eins symorder( 1) 
varargs: variable argument list 2. 1 6 1 wee te ee tt te tt we we varargs(3) 
Is: list contents of directory. . 2... 6 2 ee eee ww ee Is(1) 
uuname: list namesof UUCP hosts. .... 2... ee ee eee uuname(1C) 
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foreach: loop over listofnames. ........--. go dah Sanat tet <6? Geer 6 esh(1) 
users: compact list of users who are on the sysiem. =. 6 6 ee ee ee es users(1) 
listen: listen for connections on a socket. . 2... 2 2 se ee oe listen(2) 
listen: listen for connectionson asocket. .... 4.22.6. listen(2) 
vgrind: grind nice listings of eG Berea Ow, oe vgrind(1) 
liszt: compile a Franz Lisp program. ee ee liszt(1) 
refer: find and insert literature referencesin documents. ...- +--+ + ee es refer(1) 
In: make links. 2... 1 2 ee we ee we ee ew ewww In(1) 
index, rindex, Inbink, len: tell about character Objects. eee A ee oS index(3F) 
lo: software loopback network interface. 2... 6 6s eee 1o(4) 
loc: return the address of an object. 6 6 ww we et es toc(3F) 
convert date and time to ASCII. ctime, localtime, gmtime, asctime, timezone, tzset: ..... +. ~ ctime(3) 
(c s h only). which: locate a program file including aliasesand paths ...... which(1) 
apropos: locate commands by keyword lookup. ......+-++.- apropos(1) 
whereis: locate source, binary, and or manual for program. ..... - whereis(1) 
end, etext, edata: last locations in program. .... 2... ee ee ee ee © © end(3) 
flock: apply or remove an advisory lock onan openfile. . 2... 2 2 ee ee ee eo © « fhock(2) 
lock: reserveaterminal, . . 1. 2. 6 2 6 © 6 «© © © © © © © JOCK(1) 
plock: lock the current process incore. . . 2... + + + + + + © ~ plock(2) 
lockf: ee onfiles. . . ... ~~ lockf(2) 
lockf: provide advisory record atta bam ena ak eee A i les tele ay be We lockf(2) 
collect system diagnostic messages to form error log. dmesg: ae ee ae eee ee ae ee ee dmesg(8) 
logger: make entries in the system log. . 2... 2 ee eee eee ere ee ween logger(1) 
openlog, closelog, setlogmask: control system log. syslog, . . 2.6. 2 ee eee eee ee ween - sysiog(3) 
uulog: display UUCP logfiles. .......-.2. . ark oe - uulog(1C) 
Igamma: log gamma function. ...... 2.22 sees : - Igamma(3M) 
implog: IMP log interpreter. . . CSS wa ere implog(8C) 
power. exp, expml, log, log10, log! p, pow: exponential, logarithm, oe + ee 6 © OXpP(3M) 
syslog: log systems messages. . ..... site! Kev versie 814 ar"'s: Zo. -be sysiog(8) 
syslogd: log systems messages. . .. . oe - syslogd(8) 
exp, expm1, log, logl0, log! p, pow: exponential, logarithm, power. ce ee exp(3M) 
exp, expm1, log, logl0, loglp, pow: exponential, logarithm, power. ........ exp(3M) 
exp, expm!1, log, log10, loglp, pow: exponential, logarithm, power. . 2... 2 2 0 eee ee ee ewer exp(3M) 
manipulations. copysign, drem, finite, logb, scalb: copysign, remainder,exponent ........ ieee(3M) 
rwho: who’s logged in on local machines. . . 2... 1. 2 2 eee eee rwho(1C) 
logger: make entries in the system log. .......-+ 2.6. logger(1) 
implogd: IMP logger process. ee ae eee ee eae ae implogd(8C) 
flush: flush output toa logicalunit, 2. 2... 1 2 wee eee eee eee flush(3F) 
fseek, ftell: reposition a fileona logicalunit, . 2... 1 2 eee wee eee wees fseek(3F) 
getc, fgetc: get a characterfroma logicalunit, . 2... 1. 6 2 we eee we we eee ws getc(3F) 
putc, fputc: write a characterto afortran logicalunit, . . . 2... 2... eee Pee ee a ee ee putc(3F) 
Hogin: remote login. . 1.2... 2. 2. ee ewe eee eee wena rlogin(1C) 
ac: login accounting. . 2... 1 2 6 ee wee we we er ews ac(8) 
login: login new user. 2... 6 6 eo ee ee ee we ee esh(1) 
getlog: getuser’s loginname. . 2. 2. 2. 2 ee ee ee eee ee ene getlog(3F) 
getlogin: get loginname. . 2... 2. 2 wwe wee te we eee getlogin(3) 
login: loginnewuser, 2... 2 2 0 ce wee ee ee ew csh(1) 
/oreak, continue, cd, eval, exec, exit, export, login, read, readonly, set, = re trap/ 2... eee we sh(1) 
utmp, wimp: login records. ..... a ee ee ee ee utmp(5) 
riogind: remote login server. . ......-. Ga? Bre P et Wane rer eee rlogind(8C) 
IOGIN: SIGN ON2- vise Wak a ew: “cee ee a Rw ww in(1) 
tn3270: full-screen remote logintoIBMVM/CMS. ........4-+4+4+-e+e08 tn3270(1) 
last: indicate last logins of usersandteletypes. . 2. 2... 1 2 ee ew eee last(1) 
logout: end session. 2 2 0 1 0 2 ew et ett te csh(1) 
setjimp, longjmp: non-local goto. . . 2... 2... 2 es : setjmp(3) 
look: find lines ina sortedlist. oo... 0... 1 ee eee look(1) 
find references in a bibliography. indxbib, lookbib: build inverted index fora bibliography, ...... lookbib(1) 
apropos: locate commands by keyword lookup. .. 1... see eee eee eee eee ne apropos(1) 
finger: user information lookup program. .. 2... 1. 6 eee eee eee finger(1) 
break: exit while/foreach loop. Bb Be AG) Goh oe bac as Cour toe phe say oe Rowe tee tetas esh(1) 
continue: cyclein loop. ..... od Secs far bo ahve: Harel te, UNS se esh(1) 
end: terminate loop. oy Cav eae ha delcaeaie cbtcp. is we) Goh Breit athens ah tahie csh(1) 
foreach: loop over list of names. eye wae ah Sc ete ee ey adew Se ere, SHG) 
lo: software loopback network interface. . .. B's ee Soe 10(4) 
library. lorder: find ordering relation for an object | is Gia E> wisslasa o lorder(1) 
mklost+found: make a lost+found directory forfsck . 2... 26 2 we ee wee mklost+found(8) 
Ip: line printer. . . . . oe ee ee eee ee Ip(4) 
Ipc: line printer control program. ot es Sey eet O08 cety cd p10 268" 2S ipe(8) 
Ipd: line printerdaemon. . . 2. 2 ee ee ee ee wes Ipd(8) 
Ipq: spool queue examination program. .........% Ipq(1) 
Ipr: offline print. 2... 1 ee ee ee ee et es Ipr(1) 
queue. Iprm: remove jobs from the line printer spooling ...... Iprm(1) 
iptest: generate lineprinter ripple pattem. ......2... Iptest(1) 
Is: list contents of directory, . .. 2... 5 es ee eee Is(1) 
a Iseek: move read/write pointer. ........2...000-4 Iseek(2) 
bit: and, or, xor, not, rshift, Ishift bitwise functions. ........6.6...00808 bit(3F) 
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Stat, Istat, fstat: get file status. So eee SE ee eee ee ees stat(2) 
Stat, Istat, fstat: get file status. 2... 6 6 ee ee ee tt stat(3F) 
Leys: UUCP remote host description file. a nist let, lehvanleitial ae a L.sys(5) 
time, ctime, Itime, gmtime: return systemtime. . . . 2... 2 see ee time(3 
Ixref: lisp cross reference program. . .. +--+ > . Ixref(1) 
m4: macro processor. 2... 2 1 ee ee et ee th ee m4(1) 
bk: line discipline for machine-machine communication (obsolete). Seer ee ese oe bk(4) 
ruptime: show host status ofiocal machines.  . . 2... 2.0 5 se eee eee eee oe Tuptime(1C) 
rwho: who’s logged inon local machines. 9 . 2... 0 0 ewe eee we ee ee wns rwho(1C) 
m4: macro processor. . . 2... - 2 eo Si vee nas erie: Gap PS. SE m4(1) 
alias: shell macros. . . 2.2. 2 2 ee eee eee eee er eee esh(1) 
toupper, tolower, toascii: character classification macros. fisprint, isgraph, iscatrl,isascii, . 2... + 2s e- ctype(3) 
ms: text formatting macros. .. 2... 5.5.2.2 se eee eceee ra - ms(7) 
me: macros for formatting papers. . 2. 2. 2 eee te ew me(7) 
man: macros to manual, 2... ww ee tw ew tw te ww man(7) 
msqrt, mcmp, move, min, omin, fmin, m_in, mout/ madd, msub, mult, mdiv, pow, gcd, invert, rpow, .... . . mp(3X) 
tcopy:copya magtape. ....... Sie eo ple MeO WR - tcopy(1) 
mt: magnetic tse manipulating program. a ee ee ee ee mt(1) 
mtio: UNIX magtapeinterface. . 2. 26. eee ee eee — mtio(4) 
tm: TM-11/TE-10 magtapeinterface. ....... eo! wel ade + +  tm(4) 
ts: TS-11 magtapeinterface. 2... 2 ee ee ew ee we tt es ts(4) 
rmt: remote magtape protocel module. 2... 6 ee eee ee ee rmt(8C) 
mail: send and receive mail, 2. 0 wwe we we ee ew were ew wrens mail(1) 
encode/decode a binary file for transmission via mail. uvencode, uudecode: Ss ou euce? Lol ce, tS Sonver a8 F wuencode(1C) 
"xsend, xget, enroll": secret mail. ..... 6 Mae ata? Give de ce: es Beto xsend(1) 
sendbug: mail a system bug report to 4bsd-bugs. 68 Mat pt lah Bee wh Se sendbug(1) 
mailaddr: mail addressing description. ..... 2-2 +s eeeee mailaddr(7) 
newaliases: rebuild the data base forthe mailaliasesfile. . .......6-. a. oe a Se newaliases(1) 
binmail: send or receive mailamongusers. . 2... 1... ee ee ee ee ew ow binmail(1) 
biff: be notified if mail arrivesand whoitisfrom. ......... : biff(1) 
from: who ismy mailfrom?. . 2... 2.6 6 ee eee eet we ee wee from(1) 
sendmail: send mailovertheinternet. . . 2... ee ee ee ee eee e sendmail(8) 
R msgs: system messages and junk mail program. ....... ee ee ee eae er ae msgs(1) 
rmail: handle remote mail received viauucp. .. 2... + ee ee eee eee rmail(1) 
mail: send and receive mail. . . 1... 6 eee ee eae mail(1) 
mailaddr: mail haar pice eee el ey see ol mailaddr(7) 
mem, kmem, vmem: main memory. .. . See See a nee fo! vel ence Mee Se mem(4) 
make: maintain program groups. a el, ee Ce eee oe eer a make(1) 
ar: archive and library maintainer. . ... . ; ee ae ee eee ar(1) 
intro: introduction to system maintenance and operation commands. Nee ae ae ae . intro(8) 
vwidth: make troff width table forafont. . ... 2... ee eee vwidth(1) 
mkdir. makeadirectory, 2... 2. 1 ee we ee we ews ~ . mkdir(1) 
mkdir: make adirectory file. 2... 2. 2 we eee ee eee mkdir(2) 
link: makeahardlinktoafile. ..... 2.2. eee eevee link(2) 
link: makealinkto anexistingfile. ........2..-- . . link(3F) 
mklost+found: make a lost+found directory forfsck ........0.200-4 mklost+found(8) 
mknod: makeaspecialfile. . 2... 2... 2 ee eee eevee mknod(2) 
mktemp: make aunique filename. .. . 2... 22 2 ee ee eee mktemp(3) 
logger: make entries in the system log. SW 0) Stet 26> erties “oy oe ce logger(1) 
In: make links: > 626. 6 ss cH ee ee Se ee In(1) 
make: maintain program groups. . . . . 2... 1. 2 ee ee make(1) 
symlink: make symbolic linktoafile ........0.0c00- symlink(2) 
makedev: make system special files. . 2. 2... 2.0.2. eee eee makedev(8) 
highpri: make the current process a high priority process. ..... ; highpri(2) 
normalpri: make the current process a normal priority process. .... . normal pri(2) 
script: make typescript of terminal session. ......2.2.. . . seript(l) 
makedev: make system special files, 2... ......06-. makedev(8) 
makekey: generate encryption key. . 2... 1. 2 ee ee makekey(8) 
malloc, free, falloc: memory allocator. ........6+5 malloc(3F) 
allocator. malloc, free, realloc, calloc, alloca: memory ........ malloc(3) 
the manual. man: find manual information by keywords; print out man(1) 
man: macros to typeset manual. ..... 2... 2.206 man(7) 
shift: manipulate argumentlist 2. 2. 2 2. 2 1 ee ee ee ew esh(1) 
quota: manipulate disk quotas. ........... ‘ quota(2) 
getenv, setenv, unsetenv: manipulate environmental variables. . 2... 1... 2... getenv(3) 
tp: manipulate tapearchive. ........ a tp(1) 
route: manually manipulate the routing tables. . 2. 2... 2... 220 route(8C) 
uuq: examine or manipulate the uucp queue. . 2. 6 6 2 2 6 ee ee ee uuq(1C) 
mt: magnetictape manipulating program. . . . 26 + ee ee ee eens mit(1) 
inet_Inaof, inet_netof: Internet address manipulation routines. /inet_ntoa,inet_makeaddr, ..... inet(GN) 
finite, logb, scalb: copysign, remainder, exponent manipulations. copysign,drem, ....... 2... ees ieee(3M) 
frexp, Idexp, modf: split into mantissa andexponent. . 2... 2 6 se es wwe eae frexp(3) 
catman: create the cat files forthe manual. . . 2... 05s eee eee ey ee eee ear catman(8) 
find manual information by keywords; print out the manual. man: .. 2... 1 ee ee ee eee we ew ne man(1) 
man: macros to typeset manual. . . 2... 1 ee eee tee ee ewe nine man(7) 
whereis: locate source, binary, and or manual forprogram. .. - 2-2 ese ee ee wees whereis(1) 
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manual. man: find 
route: 
IBM 3270 keys. 
map3270: database for 
mmap, munmap: 
umask: change or display file creation mask. 
sigsetmask: set current signal 
umask: set file creation mode 
mkstr: create an error message file by 
functions. 
intro: introduction to 
math: introduction to 
eqn, neqn, checkeq: typeset 
getriimit, setriimit: control 
viimit: control 
ex: Excelan 10 
il: Interlan 10 
nw: Integrated Solutions, Inc., 10 
as: 
/msub, mult, mdiv, pow, gcd, invert, pow, msqrt, 
min, omin, fmin, m_in, mout/ madd, msub, mult, 


bed: convert to antique 


killpg: terminate all 
groups: show group 
mem, kmem, vmem: main 
malloc, free, realloc, calloc, alloca: 
malloc, free, falloc: 
valioc: aligned 
valloc: aligned 
vfork: spawn new process in a virtual 
core: format of 
vmstat: report virtual 
sail: multi-user wooden ships and iron 
sort: sort or 
pmerge: pascal file 


vacation: return ‘‘I am on vacation’’ 
mkstr: create an error 

recv, recvfrom, recvimsg: receive a 

send, sendto, sendmsg: send a 

error: analyze and disperse compiler error 
mesg: permit or deny 

perfor, sys_errlist, sys_nerr: system error 
petror, gerror, iermo: get system error 
psignal, sys_siglist: system signal 
syslog: log systems 

syslogd: log systems 

R msgs: system 

dmesg: collect system diagnostic 

mille: play 


invert, rpow, msqrt, mcmp, move, min, omin, fmin, 
/mdiv, pow, gcd, invert, pow, msqrt, Mcmp, move, 
intro: introduction to 

pages. 

miscellaneous: 


chmod: change 

getty: set terminal 
umask: set file creation 
chmod: change 
chmod: change 

frexp, Idexp, 
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manual information by keywords; printoutthe ....... man(1) 
manually manipulate the routing tables. . 2... .-. +--+ +> route(8C) 
map3270: database for mapping ascii keystrokesinto . . . . map3270(5) 
mapping ascii keystrokes into IBM 3270 keys. ..-- ++. map3270(5) 
pi i re ee eee ee ee mmap(2) 
<a we es Bese a: Re eS oe & Sew csh(1) 
Mask eh ee Mirae ke ee Ke eS we Se ee ES + » sigsetmask(2) 
MASK: ese co We HS! GS co! te BE Se nw RS es SOE OS umask(2) 
massaging Csource, . 2... 2... 2 ee eee eee mkstr(1) 
math: introduction to mathematical library . .... +--+ - math(3M) 
mathematical library functions. .......2-2+e2e%e-s intro(3M) 
mathematical library functions. . .... 2.2. +2 ee ee - math(3M) 
mathematics. . 6... 0 eee eee ee ew we ee OQ) 
maximum system resource consumption. ......+.+.--. getriimit(2) 
maximum system resource consumption. ..... +--+... vlimit(3C) 
Mb/s Ethernet controller, . 2. 2... 2 2 eee ee eee ex(4) 
Mb/s Ethernet controller. . 2... 2.0.26 6 6 © © © © «© il(4) 
Mb/s Ethemet controlier,  .. 2... 2 2 ee ee eee nw(4i) 
MC68000/MC68010/MC68020 assembler. . oe ee e Ol) 
memp, move, min, omin, fmin, m_ in, mout, omout/ oe e + « mpGX) 
mdiv, pow, god, invert, pow, msqrt,mcmp,mMove, .... . mp(3X) 
sia: wiacros for forunliing pepsrk ee ae a ee ae a me(7) 
Media, 66 6 ce ee 6 8 eet ee ee 8 ew 8 ce bed(6) 
mem, kmem, vmem: main memory. ...-. + ss ses mem(4) 
members of a process group. «2. 6 6 ee ee ee ee es killpg(8) 
memberships. ... 2. +s eee . ae groups(1) 
memory, 22 ee wet twee ee Siviehs6! x8 Son teh Vere mem(4) 
memory allocator, . 2... - 6 2 2 eee ee ee eee malloc(3) 
memory allocator. ..... barb Me he Bld. WER malloc(3F) 
memory allocator. ee ee ee et ee ae valloc(3) 
memory allocator. . . Bi iain One nie Mohs: ofan, 8? x0? Oe valloc(3C) 
memory efficient way. ... . et ae Sor ey (ie, hl aS vfork(2) 
memory image file Nagle Gise ey toh eirlol-@. ates ee ees eee core(5) 
memory statistics Pe ee ee er ee ee ee vmstat(1) 
Men, 2. 2 2 a bi ece ce Se ea ae SS la ee ae sail(6) 
mere files. 2... 1 2 ee ee ewe we ee we we ee ww sort(1) 
IIOTBOT. os. co: es oe. ee, Be eee as 0 Se eS pmerge(1) 
mesg: permit or deny messages. .....- ++ . . mesg(1) 
message. . 2 2 ee ew tet te ew we we ee we te vacation(1) 
message file by massaging C source. . 2... ..-.-2-06-. mkstr(1) 
message fromasockel. 2... 6 0 ewe ee we we eee recv(2) 
message fromasockeL 2... 22 2 2 0 ee we we ee send(2) 
messages. 8g ww we et tte tt te tt th te ts error(1) 
messages. gw ww wt et ttt wt tt tw te tt mesg(1) 
messages. 8. 1 1 ww ww ew ww ee fey Se Gece Scere tay 8S perror(3) 
messages. 2... 1 ee ee ee ee ee ee ee perror(3F) 
messages. oe ee Me GAS tel ciel as Be leh 6 eS, Sr Jott a psignal(3) 
MNOSSASES 5g wie ce SW le fe ee ee) ee sere ar Sel sysiog(8) 
messages. . So Ness 16) tebe w! ey, OL Uel ne car. ee syslogd(8) 
messages and junk mail program. as el de: serra baer an Cocke ere 4a msgs(1) 
messagestoformerrorlog. . 2... 2. 2 ee eee eee dmesg(8) 
Mille Bournes. . 2. 0 0 2 ew te ew tee ewe ww we mille(6) 
mille: play Mille Boumes. . 2... 2 2. 2 2 ee ee eee mille(6) 
m_in, mout, omout, fmout, m_out, sdiv, itom:/ /gcd, - » mp(3X) 
min, omin, fmin, m_in, mout, omout, fmout, m_« out/ . mp(3X) 
miscellaneous library functions. ....-.....085 intro(3X) 
miscellaneous: miscellaneous useful information ...... intro(7) 
miscellaneous useful information pages.  .. 2... 2 6 intro(7) 
mkdir: make adirectory, 2... 6. 1 ee eee ee ees mkdir(1) 
mkdir: make a directory file. Breas Benes Gite cai ek os Be mkdir(2) 
mkfs: constructa file system. .........24.. 2. . mkfs(8) 
mkhosts: generate hashed host table. . . . » + « « « mkhosts(8) 
mkiost+found: make a lost+found directory for fack. . + + « + mklost+found(8) 
mknod: build special file. . . 2. 2... 6 2 ee 6 es + ~ mknod(8) 
mknod: make a special file. . 2... ..... 2 «ee ~~ =mknod(2) 
mkpasswd: generate hashed password table. ........ mkpasswd(8) 
mkproto: construct a prototype file system. ........ mkproto(8) 
mkstr: create an error message file by massagingC ..... mkstr(1) 
mktemp: make a unique filename. ....... . mktemp(3) 
mmap, Munmap: maps or unmaps pages. . ... 2... 5. mmap(2) 
mode. ..... ee ee ane a ee ae ee Sone @AE Re el ee chmod(1) 
mode. 2. 6 6 ee ee ee ee we oe . getty(8) 
mode mask: coo: o> 6) Sede el Oe Re a we Oe, umask(2) 
mode of a.file. 3. 6+ a <5 Sr 6 We oe we ee Viton Gee chmod(3F) 
mide OF fil6- 9 sss Gi ee eae Sw ea ee chmod(2) 
modf: split into mantissa andexponemt. .......... frexp(3) 
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touch: update date last 

rmt: remote magtape protocol 
what: show what versions of object 
monitor, monstartup, 

profile. 


monop: 
monitor, 


curses: screen functions with ‘‘optimal’’ cursor 
mount, umount: 
mount: 


/etc/mtab: 

/rpow, msqrt, mcmp, move, min, omin, fmin, m_in, 
/move, min, omin, fmin, m_in, mout, omout, fmout, 
plot: openpl, erase, label, line, circle, arc, 

‘mult, mdiv, pow, gcd, invert, rpow, msqrt, mcmp, 
R mv: 


Iseek: 
hk: RK6-11/RK06 and RKO7 
rk: RK6-11/RK06 and RKO7 


R 
madd, msub, mult, mdiv, pow, gcd, invert, rpow, 
memp, move, min, omin, fmin, m_in, mout,/ madd, 


move, min, omin, fmin, m_in, mout,/ madd, msub, 
hunt: 2 

fmin, m_in, mout, omout, fmout, m_out, sdiv, itom: 
dh: DH-11/DM-11 communications 
di; DL-11 communications 
dz: DZ-11 communications 
‘select: synchronous I/O 
fsplit: split a 
hunt: a multi-player 

sail: 

switch: 
mmap, 

R 

from: who is 
getdiskbyname: get disk description by its 
getdiskbyname: get disk description by its 
getlog: get user’s login 
getlogin: get login 
getsockname: get socket 
pwd: working directory 
tly: get terminal 
hosts: host 
networks: network 
protocols: protocol 
services: service 
whois: DARPA Internet user 
getpw: get 
nlist: get entries from 
nm: print 
symorder: rearrange 
rename: change the 
ttyname, isatty, ttyslot: find 
ttynam, isatty: find 
getpeername: get 
domainname: set or display 
gethostname, sethostname: get/set 
hostnm: get 
hostname: set or print 
named: Internet domain 
named: Internet domain 
bind: bind a 


foreach: loop over list of 
term: conventional 
ncheck: generate 
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modified of a file on, eA ae oe ee ee a a touch(1) 
TROGUIE pra gee eas ay, ew Ne) SS OS F rmt(8C) 
modules were used to constructafile.  . 6. 6 2 6 ee oe what(1) 
moncontrol: prepare execution profile. ..... ++ ++. monitor(3) 
monitor, monstartup, moncontrol: prepare execution . . . . . monitor(3) 
monop: Monopoly game. . 2... 2-6 ee ee ee eee monop(6) 
Monopoly game. . 2... 1 ee ee ee ee eh we ees monop(6) 
monstartup, moncontrol: prepare execution profile. .... . monitor(3) 
more, page: file perusal filter for crt viewing. . ... +. +. more(1) 
motion. aie. oP ele. ter Be toe eiante: i eco ae! estate curses(3X) 
mount and dismount filesysiems. ...... =. .- +. . + mount(s) 
mount file sysiem. . 2... 2.2 eee eevee eten< mount(2) 
mount: mount file sysiem. . 0... 2 2s eee ee we mount(2) 
mount, umount: mount and dismount ‘filesystems. Sete eve mount(8) 
mounted file systemtable. . 2... 22 2 ee eee eee mtab(5) 
mout, omout, fmout, m_out, sdiv, iiom: multiple/ . . - « mp(3X) 
m_out, sdiv, itom: multiple precision integer)... .. . . mp(3X) 
move, cont, point, linemod, space, closepl/ ..... . ~~ plot(3X) 
move, min, omin, fmin, m_i a ener e+ 6 © « «mp(3X) 
move orrename files. 2... 0.6 2 0 0 se ee © ee © 6mv(1) 
move read/write pointer. . . aye 6 en Iseek(2) 
moving headdisk. .......- ries tec Aw See cas Me hk(4) 
moving head disk, 2. 2... 22. 2 eee eee ee eee rk(4) 
ms; text formatting macros. .. 2... 2+ eee eee 
meet: retrieve ASCII to IBM 3270 keyboard map. . 22.2. mset(1) 
msgs: system messages and junk mail program. ...... msgs(1) 
msqrt, mcmp, move, min, omin, fmin,m_in,mout/ ..... mp(3X) 
msub, mult, mdiv, pow, gcd, invert, pow, msqrt, ...... mp(3X) 
mt; magnetic tape manipulating program. ......... mit(1) 
mtio: UNIX magtape interface, 2. 6 6 1 ee ee ee es mtio(4) 
mult, mdiv, pow, gcd, invert, rpow, msqit, mcmp, . .... . mp(3X) 
multi-player multi-terminal game. . . .. 2 - + 2 ee oe hunt(6) 
multiple precision integer arithmetic. /min,omin, ..... . mp(3X) 
Tiptiplexer.” 6c 8 i Se Swe ew dh(4) 
multiplexer. . 2... 2... . oe ee er ee eee dl(4) 
multiplexer. . .... falc do hetelee reicieh eis es ete facies 28 dz(4) 
multiplexing. «6.6 eo 8 we Hee ws Ow ee select(2) 
multi-routine Fortran file into individual files. .....4.. fsplit(1) 
multi-terminal game. 2 2 1. 2 1 0 ee ee ee et ww hunt(6) 
multi-user wooden ships and i iron Ws 66 ce Se SK sail(6) 
multi-way command branch, . . 2... 2 2 ee ee eee csh(1) 
munmap: maps or unmaps pages. 2. 6 ee ee ee ee mmap(2) 
mv: move orrename files. . 2... 2.0.6 2 ee ee eee mv(1) 
my mailfrom?. ........ Se er ee ae a ee ae from(1) 
name. . 0 we ee ‘ By fanaa sted Rs Se ee, a. Se getdisk(3X) 
mame. «2 2 ww ew ee siatiay sone aye baxroee cee ee s getdiskbyname(3) 
MANE 66 oe Se. SS Aig el eS: Reet. eae cat GY getlog(3F) 
BAMC. 6 eS el 6; eS. ee eae SB Ne Ser age Gore getlogin(3) 
name. ee a a wi a a er ie, Se it ah sere, ew 8 getsockname(2) 
MIME. - 6.6058 6. ee eS 8 Ric He! coc sen caste loose ce! vay wiles S pwd(1) 
mame. ..... oie a es ee. ie tas Nah eter WE: Se). eee tty(1) 
name database. .. 1... 2. ee eo ee we ew we ww we hosts(5) 
name database. 2... 2 2 ew we eee ee ee ee networks(5) 
name data base. oi “ayia? “oo ee! ie Sie) et BY Gece s,s protocols(5) 
mame database. ...... acta! i wei fo deiges eel BE re. ee services(5) 
name directory service, ... 2.6 6 2 ee we ee we wee whois(1) 
mamefromuid. 86 6 ws te tee tw ee es getpw(3C) 
mame list. ...... eer is ait sg 6.8) er saa e ATS nlist(3) 
Marnie lists. 6. 6. séi0ie. Si eres, erm: bo OF eee 8 ee ee nm(1) 
wae list. eo 6-5ah oeeree: See Se Poe ee eS . « symorder(1) 
name oF a file, 4. i wie So ee we es . » Tename(2) 
name ofaterminal. . .......-2220006.. = tyname(3) 
name of aterminal port. . 2... 2.2.5.2... es. tynam(3F) 
name of connected peer. . 2... 2+ ose ee « Betpeername(2) 
name of current domain sysiem. .. 2... 5.2.6 ee ee domainname(1) 
name of currenthost. 2... 6. 2 ee eee eee ee gethostname(2) 
name of currenthost. .......20.0.6 emai ae dna hostam(3F) 
name of current host sysiem. .....-... oe ass os hostname(1) 
PAINE SETVER. ke ee a a et named(8) 
WAMOAERVER go was be a se Se ES TES ae named(8C) 
mametoasocket. . 0. 6.5 6 ee ee we we we we ew even bind(2) 
named: Internet domain name server. . ........2-6 named(8) 
named: Internet domain name server. . .. 1... ww eee named(8C) 
DOMES 2 55 ie) Oe, ol US ce, oe ee eee ee te ae esh(1) 
mames forterminals, .. 2... + © ee eee eevee term(7) 
names fromi-numbers. .. 1... 652s ee eee ee ncheck(8) 
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uuname: list 
eqn, 


rdump: file system dump across the 

Trestore: restore a file system dump across the 
ntohi, ntohs: convert values between host and 
getnetbyname, setnetent, endnetent: get 
gethostent, sethostent, endhostent: get 

ping: send ICMP ECHO_REQUEST packets to 
lo: software loopback 

ifconfig: configure 

slattach: attach serial lines as 

intro— introduction to 

networks: 

routed: 

netstat: show 

networking: introduction to 


Creat: create a 
open a file for reading or writing, or create a 
newfs: construct a 
fork: create a 
vfork: spawn 
login: login 
adduser: procedure for adding 
aliases file. 


dbminit, fetch, store, delete, firstkey, 
gettable: get 

htable: convert 

verind: grind 


(s bh only). nice 


only). nice, 


setjmp, longjmp: 

normalpri: make the current process a 
priority process. 

bit: and, or, xor, 

notify: request immediate 

biff: be 


soelim: eliminate .so’s from 
tbl: format tables for 
colcrt: filter 


troff, 

deroff: remove 

vip: Format Lisp programs to be printed with 
checkar: check 

XNSrouted: 

routines. 

ns_addr, 

ns_addr, ns_ntoa: Xerox 

network byte order. hton!, htons, 

order. htonl, htons, ntohl, 


phones: remote host phone 

arithmetic: provide drill in 

rand, srand: random 

random, drandm, irandm: better random 
random, srandom, initstate, setstate: better random 
L-dialcodes: UUCP phone 

atof, atoi, atol: convert ASCII to 
intro: introduction to system calls and error 
number: convert Arabic 

idate, itime: return date or time in 
controller. 

Firmware status. 

loc: return the address of an 
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names of UUCP hosts. 1... 1.2.0.0. ee eee eee uuname(1C) 
ncheck: generate names from i-numbers. ...... 5% ncheck(8) 
neqgn, checkeq: typeset mathematics, .. 2... 2.22 2 es eqn(1) 
netstat: show network status. 9... 2. 1 ee es . « « hetstat(1) 
BOCWOIK as ii S041 el Sole we a Se ee &, rdump(8C) 
metwork, 6... 2 se ee ee ee ee we wes vas rrestore(8C) 
network byte order. "htonl, tons, 6 ww ew te we te ww byteorder(3N) 
network entry. getnetent, getnetbyaddr, .. 2... 2.2. 6 es getnetent(3N) 
network host entry. gethostbyname, gethostbyaddr, a ee ate. 6 gethostbyname(3N) 
metwork hosts. 2... 2 2 2 ee ee ee we et ee ping(8) 
metwork interface. 6 6. 0 1 ee ewe ew ww ew 10(4) 
network interface parameters. ...... AS eso) 28 GEES ifconfig(8C) 
metwork interfaces. 0. 0. 6 0 ee eee we we ee ws slattach(8C) 
network library functions. . . 2... 2. 2 ee eee eee intro(3N) 
metwork mame data base. 2... 6 5 6 + ee ee we ee ws networks(5) 
network routingdaemon. . 6. 2-6 ee ee ees » Youted(8C) 
network status. ww tt tt ee ee ww  Metstat(l) 
networking facilities, . 2. 2. 2 6 ee ee ee © © © © imtro(4N) 
networking: introduction to networking facilities. oe ee © © 6amtro(4N) 
networks: network name data base. Bie tet wae eye cee OS - Betworks(5) 
newfie. 2. 0c eee eee a ie, eb len@! ce ete . creat(2) 
mew file. open: . . 2.2 es ee ee ee es erst: Ghiyer a0 oe open(2) 
new filesystem. . . 2.2 2 ee eee : - e« » = newfs(8) 
mew process, ww ww tt tt te ew © «6 6 6 6 © ©fork(2) 
new process in a virtual memory efficient way. ...... . Vfork(2) 
MEwuser, 2. 2. 2 2 0 ww we ww te ww ww tia: Z . esh(1) 
MewWuUserB. 6 ww ee tt te wt tt eee adduser(8) 
newaliases: rebuild the data base for the mail a8) We ers sas aie newaliases(1) 
newfs: construct a new file sysiem. . ........26- newfs(8) 
nextkey: data base subroutines. . 2... 2. 2 2 ee eee dbm(3X) 
NIC format host tables fromahost. .........2.. gettable(8C) 
NIC standard format host tables. . 2... 6 5 0 ee ew es htable(8) 
nice listings of programs.  . . 2... 6 2 ee ee ee ee vgrind(1) 
ice, nohup: run a command at low priority ........ nice(1) 
nice: run low priority process. . 2. 2 6 6 2 ee ee ee es csh(1) 
nice: set program priority, 2 2. 2. 6 6 ee ee ew et et nice(3C) 
nlist: get entries from name list. 2... 2... 2 2 ee ee nlist(3) 
mm: printname list. 2 2. 1 0 eee ee tt te we es nm(1) 
nohup: run a command at low priority(sh ........ nice(1) 
nohup: run command immune tohangups. ......... csh(1) 
non-local goto. 8. 6 ww ee et te wt eh tee es setjmp(3) 
normal priority process. ....... Be G8. Ore ee se » pormalpri(2) 
normaipri: make the current processanormal ....... normalpri(2) 

not, rshift, ishift bitwise functions. ..........60- bit(3F) 
Silesian Pa ear a ee at ie ae eae ee csh(1) 
notified if mail arrives and who it ISTFOM,. 96 6 ee ee se ee eS biff(1) 
notify: request immediate notification. .......-2.-. csh(1) 
nroffinput. ..... eee eG: Oe eens, eid woe en soelim(1) 
mroffortroff. . 2. 6 ee ee ee we wt we ww es tbl(1) 
nroff output for CRT previewing. ai Pe aie 1'b8 gs SR ASE esa colcrt(1) 
mroff: text formatting. ... 2... 2.2 2 eee eevee nroff(1) 
nroff: text formatting and typesetting. ......4.242. troff(1) 
nroff, troff, tbl and eqn constructs. . ........6240- deroff(1) 
nroff, vtroff, ortroff. 2... 1 2 ee we ee ee . vip(1) 
mroffftroff files. 6... 1 ee we we we ww www ws checknr(1) 
NS Routing Information Protocol daemon. ......6.. XNSrouted(8C) 
ns_addr,ns_ntoa: Xerox NS(tm) addressconversion .. . . ns(3N) 
ns | - mtoa: Xerox NS(tm) address conversion routines. . . . . 1s(3N) 
NS(tm) address conversion routines. ........02.4. ns(3N) 
ntohl, ntohs: convert values betweenhostand ....... byteorder(3N) 
ntohs: convert values between host and network byte . . . . byteorder(3N) 
Mull: Gate Gig. i 6. Gs we 9 ee ES Kw » null(4) 
number: convert Arabic numerals to English, ..... . . number(6) 
number database, 2 6 2 1 ee ee et ee ee phones(5) 
mumberfacts, 1... 6 ce ess eee ere we nas arithmetic(6) 
mumber generator. . .. Pree a Ver Gate tenle une rand(3C) 
mumber generator, 6 6 www ee tt tt te ee random(3F) 
number generator; routines for changing generators. ss tara ye random(3) 
mumber index file. 6... 6 0 1 ew eee te ee we we L-dialcodes(5) 
MUMDETS 5 esa ee eee el SA) Bhs ol BPS eae Se es atof(3) 
mumbers. 2. 6 0 ew ett et te et we th ww ww ws intro(2) 
numerals to English. Scab hiep de cee te tainter cae wen ecde Sore e number(6) 
pumericalform. . 6... 6 eee ee we ee tw we ww idate(3F) 
nw: Integrated Solutions, Inc., 10 Mb/s Ethernet  . 2... nw(4i) 
nwstat— report Ethernet Packet Transmission ........ nwstat(8) 
ODJECE 5 ke ese RR, EUS Nee te Swe eae eS loc(3F) 
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jong, short: integer. 

size: size of an 

lorder: find ordering relation for an 

what: show what versions of 

strings: find the printable strings in a 

index, rindex, inbink, len: tell about character 

line discipline for machine-machine communication 
od: file dump 


/pow, gcd, invert, Tpow, msqrt, mcmp, move, min, 
/msqrt, mcmp, move, min, omin, fmin, m_in, mout, 


nohup: run a command at low priority (3 h 
program file including aliases and paths (c s h 
file. open: 

fopen, freopen, fdopen: 

flock: apply or remove an advisory lock on an 
a new file. 

Closedir: directory operations. 

syslog, 

cont, point, linemod, space, closepl:/ plot: 
(3X) libraries.. plot: 

savecore: save a core dump of the 

kgmon: generate a dump of the 

intro: introduction to system maintenance and 
tgetstr, tgoto, tputs: terminal independent 
bcopy, bcmp, bzero, ffs: bit and byte string 
telidir, seekdir, rewinddir, closedir: directory 
strepy, stmepy, strien, index, rindex: string 
infnan: signals invalid floating-point 

join: relational database 

curses: screen functions with 

gctopt: get 

stty: set terminal 

getsockopt, setsockopt: get and set 

ntohs: convert values between host and network byte 
lastcomm: show last commands executed in reverse 
lorder: find 
bessel functions: of two kinds for integer 

vi: screen 

a.out: assembler and link editor 

terminate a process after flushing any pending 
Write, writev: write 

ecvt, fevt, govt: 

printf, fprintf, sprintf: formatted 

fold: fold long lines for finite width 
colcrt: filter nroff 

flush: flush 

foreach: loop 

sendmail: send mail 

trapov: trap and repair floating point 

exec: 

chown: change 

chown: change 

quot: summarize file system 


trep: transliterate sequenced 

nwstat— report Ethernet 

ping: send ICMP ECHO. REQUEST 

more, 

getpagesize: get system 

pagesize: print system 

miscellaneous: miscellaneous useful information 
mmap, mMunmap: maps or unmaps 


tk: 
swapon: specify additional device for 
drum: 


swapon: add a swap device for interleaved 
socketpair: create a 

me: macros for formatting 

ifconfig: configure network interface 
diskpart: calculate default disk 

pe: 

pxref: 

pmerge: 
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Object conversion. ee a ee ee long(3F) 
Objectfile. 2 2. eww twee we ee ‘ size(1) 
Object library, 2. 2... 2 2 ee eee : ee + « « lorder(1) 
object modules were used to constructafile. .......-. what(1) 
object, or other binary, file. 2... 2. 2 ee ee ee eee strings(1) 
objects. 6 ww ee ew hae Ta. Gc SSE ce eel index(3F) 
(obsolete). bk: ww ww ee ett ew ies Ge Wee bk(4) 
(octal, decimal, hex, ascii), 2... 6. eb we we ew we ew od(1) 
od: file dump (octal, decimal, hex, ascii). . 2... 2... od(1) 
omin, fmin, m_in, mout, omout, fmout, m_out, sdiv/ .. . . mp(3X) 
omout, fmout, m_out, sdiv, itom: multiple precision/ . . . . mp(3X) 
onintr: process interrupts in command scripts. ....... esh(1) 
only), nice,... 2.0 see eee ce eee ree eo ens nice(1) 
only). which: locatea 2. 2 2 0 we ee ee te te which(1) 
open a file for reading or writing, orcreatleanew ...... open(2) 
Openastream. 2 61 eee ee ee we ee ee tw we fopen(3S) 
Openfile, 2... 2 ee ee ew eee ee ee wo wo  fiock(2) 
open: open a file for reading or writing, orcreate .... . . open(2) 
opendir, readdir, telldir, seekdir, rewinddir, .... .. . . directory(3) 
openiog, closelog, setlogmask: control systemlog. ... . . syslog(3) 
openpl, erase, label, line, circle,arc, move, ........ plot(3X) 
openp] et al.: {77 library interfacetop lot ....... plot(3F) 
operating sysiem. ww we ee ee te tt te te savecore(8) 
operating system’s profile buffers. ee a ee ee ee ee ae kgmon(8) 
operationcommands. ........-+- Sah Cotes cee Te intro(8) 
Operation routines. tgetent, tgetnum, tgetfiag, ....... termcap(3X) 
operations. 6... ee eS ee te ete ee ee tw bstring(3) 
Operations. opendir,readdir, . 2... 2 2 2 ee ee eee directory (3) 
Operations. strcat, strncat, strcmp, stmcmp, ........ string(3) 
operations ona VAX (temporary), . . 2... 2 + 2 ee ee infnan(3M) 
Operator, 2 es tee ww he etal Whos Het Bree 8. al Fe join(1) 
“‘optimal’’ cursormotion. . 2... 2.2 2 se ee ee eee curses(3X) 
option letter fromargy. . 2 2 2. ee ee ee we wee getopt(3) 
options. 2... 2 2 ee ee ewe les Tas Be. Se acacia, al Per ie? stty(1) 
options on sockets. 2 2. 2 6 2 ee ee ee we we eww getsockopt(2) 
order. htonl, htons,ntohl, . 2... 6 6 ee ee te ee ws byteorder(3N) 
Order, 2.6 wee wwe ne aus es Wade) sto ein'os segs: oat Se lastcomm(1) 
ordering relation for an object library. siete ndey a ee Sayes erie lorder(1) 
OVders. . 2... es > eas eiand creo ter cate Slate or noe) si ve bessel(3F) 
oriented (visual) display editorbasedonex. ........ vi(1) 
QuipuL 2 6 6 we we ee we tt ww we we te te a.out(5) 
output. exit: Blane) Bester ne hoes <o7 Ses lentes Bie ie TO tee. exit(3) 
OUipuL 6 ww ww we et tw Wiulgclia “get helo, Ce ae sone write(2) 
output conversion. ........-. oh Tet ieee teh ecvt(3) 
output conversion. . 2. 6 6 6 ew ee ee eee ee printf(3S) 
QUIPUL DEVICE... ck 65 es Sete ee ee Be we we OS fold(1) 
output for CRT previewing. .......2.2.-22200- colert(1) 
outputtoalogicaluni. ...... 6c aides Tee See Aw. Sante flush(3F) 
overlistofmames. . 2... 26 ee ew ee ee eww esh(1) 
Overthe intemet. 2... 2 2 ee wee ee ewe ew sendmail(8) 
overflow. 2. 2 se ce eee ee we ews . trapov(3F) 
overlay shell with specified Seeman! ehiel loro Ore Tes ver Tas esh(1) 
owner. ‘ o Nacees ciel 1 ters 1. Veysle iel tot 6 al'ge “en tewar tsi vie chown(8) 
owner and group of afile 1. ....4. ee igela? Sac Se See ote chown(2) 
ownership, ..... Cee IE el BAe ee cae eee hg Se quot(8) 
pac: printer/plotter accounting information. ........ pac(8) 
packet protocol trace, 6 6 6 6 6 6 ee wee ew ew we trep(8C) 
Packet Transmission Firmware status. .......-..405 nwstat(8) 
packets to network hosts, 6 ww ww ee ee ee ee ping(8) 
page: file perusal filterforcrt viewing. ........2.. more(1) 
pagesize. 2. wee wee ee we wee ne ee ee getpagesize(2) 
PARC CLE. cs ee Ne ON Hee ee ee pagesize(1) 
PORER erie ee So ie a SE RS intro(7) 
pages. a ee ee ee rer ts 4) 
pagesize: print system page size. ...... Poe ae ee ae pagesize(1) 
paginator forthe Tektronix 4014. .......-2..042. tk(1) 
paging and swapping. .......- 22+ eee . . swapon(8) 
paging device. wiv tat toa We Sais to ie Me! US, a on Se wae eae area drum(4) 
paging/swapping. ....... ae ae et ee swapon(2) 
pair of connected sockets. 2 0. 1. 1 6 ee eee ee ees socketpair(2) 
papers. ... 2.2 2s ee ee ee oe ee ) 
parameters. 2.0 ce eee eee ee ewe ee wes ifconfig(8C) 
partition sizes. a Saijal, toy bree: Hei, cos Soe Hae seh oeeS) waste o> oes diskpart(8) 
Pascalcompiler, 2. 6 6 6 0 ee eee ee ew ee es 1) 
Pascal cross-reference program. . . 2... 2... ee eee pxref(1) 
pascal filemerger, 2 2 2 0 0 ee eee ee ee ew ewe pmerge(1) 
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chfn, chsh, passwd: change password file information. ......-- passwd(1) 
passwd: password file, 2... 11 1 we eee te es passwd(5) 
getpass: reada password, 2... ww et tt tt tt te getpass(3) 
Pe ge or ee eee en av ernie passwd(5) 
vipw: edit the passwordfile. .... eisai tae Sar be, “G4 aly das tw at a a vipw(8) 
getpwnam, setpwent, endpwent, setpwfile: get password file entry. getpwent, getpwuid, .....-46-. getpwent(3) 
chfn, chsh, passwd: change password fileinformation.9 . .. 2... 2. 2 es eee ee passwd(1) 
mkpasswd: generate hashed passwordtable, 2... 2 6 0 ee eee ee ee es mkpasswd(8) 
getwd: get current working directory pathname. Behe ee cen “erie fe) eters BS ek Ww See SoS! ee getwd(3) 
getcwd: get pathname of current working directory, 2... 2 ee ee ee d(3F) 
USERFILE: UUCP pathname permissions file. . 2... 2. 2 2 eee ee eee USERFILE(5) 
which: locate a program file including aliasesand paths(c s h only), ...... ee ae ae ae ae ee ee ae which(1) 
R grep, Regrep, fgrep: searchafilefora pattem. ..... ‘ ig bo erties cece ene coe Weel oie grep(1) 
Iptest: generate lineprinterripple pattem. .. 2. 2. eee eee ewe eee ee eres Iptest(1) 
awk: pattern scanning and processing language. ae a ae eee awk(1) 
pause: stop until signal 2. 1 we ee ee et ee es pause(3C) 
pe: Pascal OE hc 8 ae ee ee ee oa ped) 
popen, pclose: initiate I/O to/from a process. . ... ~~...» + + « popen(3) 
getpeername: get name of connected peer. . 2. 2 2 ee eee ee ew we ee ee we oe ee + 6BOtpeermame(2) 
exit: terminate a process after flushing any pendingoutput ........ oe eee ee ow OX) 
automatically. admin: perform routine system administration tasks eee ee ee admin(8) 
L.cmds: UUCP remote command permissionsfile. 2... 2. 2. 2 2 ee ee ee ee ee ws L.cmds(5) 
USERFILE: UUCP pathname permissionsfile. .......... ata ee oe USERFILE(5) 
mesg: permit ordeny messages. 9... 1 2 ee eee eer oe mesg(1) 
pox: permutedindex. ... 2. 2 2 eee ee ee ee ee ee px(1) 
limit: alter per-process resource limitations. . . . 2... 6 e+ ee ee csh(1) 
perror, gerror, iermo: get system error messages. ..... . perror(3F) 
messages. perror, sys errlist, sys merr:systemerror ..... 2... perror(3) 
sticky: persistent text and append-only directories. ........ sticky(8) 
more, page: file perusal filterforcrt viewing. .. 2... 225 eee eee more(1) 
phones: remote host phone number data base. 2. 2 2. 6 ee ee ee eee we phones(S) 
L-dialcodes: UUCP phone number index file. . 2... 2 2 2 ee ee ee ee L-dialcodes(5) 
phones: remote host phone number data base. ....... phones(5) 
tc: photoypesettersimulator, 2... 2... 2 2 ee ee eens te(1) 
addresses. phys: allows a processto access physical ... 1... + es phys(3C) 
phys: allows a process to access physical addresses. 2 2 2. 2 0 2 ee ee ee we ee es phys(3C) 
hosts. ping: send ICMP ECHO REQUEST packets to network ping(8) 
pipe: create an interprocess communication chamnel. . . . . . pipe(2) 
tee: pipefitting ...... Berg gs es We vetoie! el ces “se Awhlbel aehcel ts tee(1) 
bg: place jobin background. . 2... 1 1 ee ee eee ee esh(1) 
fish: play “Go Fish” 6-6 eos es ee a a fish(6) 
mille: play Mille Bournes. . .. 2-2 - ees Sie tan We epee mille(6) 
boggle: play the gameofboggle. 2. 2 2 2. ee eee ee ees boggle(6) 
worm: Play the growing worm game. .......2-2+2s2-5 worm(6) 
plock: lock the current process incore. . 2... 2.2.2 ee plock(2) 
plot: graphics filters. 2... 2. 2 ee ee eee ewe plot(1G) 
plot: graphics interface. 2. 2 2 2. ee eee ee ee plot(S) 
move, cont, point, linemod, space, closepl:/ plot: openpl, erase, label, line, circle,arc, . 2... 2... plot(3X) 
p | o t (3X) libraries.. piot: openpl et al.: f77 library interfaceto . 2... 2... plot(3F) 
pmerge: pascal file merger. . 2 2 2 2 eee ee ee es pmerge(1) 
trpfpe, fpecnt: trap and repair floating pointfaults, . 2... 1. 6 2 ee eee te we wee ee trpfpe(3F) 
/erase, label, line, circle, arc, move, cont, point, linemod, space, closepl: graphics interface. . ..... plot(3X) 
trapov: trap and repair floating pointoverflow. .. 2... 6 ee eee ee ew ee es trapov(3F) 
Iseek: move read/write pointer, . 2 2-5 2 ee eee ee ee ee ee es Iseek(2) 
uupoll: pollaremoteUUCP site. 2... 2.2 eee ee eee uupoll(&C) 
popd: pop shell directory stack, 2... 2 ee eee eevee cesh(1) 
popd: pop shell directory stack ........ oe + 6 © 6O8h(I) 
popen, pclose: initiate ied calsiameel aacan beat Saeasath ao ce ane Sy popen(3) 
ttynam, isatty: find name of aterminal port. ..........-. one ee eee ee ttynam(3F) 
exp, expm1, log, logl0, logip, pow: exponential, logarithm, power. a Mee ta ieee See eal exp(3M) 
omin, fmin, m_in, mout, madd, msub, mult, mdiv, pow, gcd, invert, rpow, msqrt, mcmp, Move, min, ...... mp(3X) 
log, log10, loglp, pow: exponential, logarithm, power. exp,expml, . 2. 2. 2 6 2 6 ee ee ee ee ee 6OXP(3M) 
pr:printfile. ...... . . cee ee + pal) 
mout, omout, fmout, m_out, sdiv, itom: multiple precision integer arithmetic. /omin, fmin, m_ in, a> Si ae Mp) 
monitor, monstartup, moncontrol: prepare execution profile. . ©... 66+ es eee ee monitor(3) 
colcrt: filter nroff output forCRT previewing. . 2... 2-2 2 eee eee eee 3 colert(1) 
types: primitive system data types. Mae ee ae ee ae ee ee a types(5) 
cat:catenate and primt. 2... 2 eee ee te te ee ete ee ees cat(1) 
Ipr: Off line print. . 2. 2 ee ee we ee eee ewe were ne Ipr(1) 
fortune: print a random, hopefully interesting, adage. Ba eee ears fortune(6) 
date: printandsetthe date. 2... 2. eee eee eee ene date(1) 
cal: printcalendar, 2. 2. 1 1 1 ee ee ee ee eee ew cal(1) 
hashstat: print command hashing statistics. ...........0% esh(1) 
jobs: printcurrentjoblist. 2. 6 26 ee eee ee ee csh(1) 
whoami: print effective currentuserid. 2... 1.2 eee ee ewe whoami(1) 
pr: pnntfile, 2... 2. 2 ee ee Re are ee ee a pr(1) 
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fpr: print Fortranfile. 2. 2... 6 1 2 eee ee te te www fpr(1) 
history: printhistoryeventlis. .. 2... 2. 2 eee ee eee csh(1) 
hostid: set or print identifier of current host system. . . 2. 2 6 ee oe hostid(1) 
banner: print large banneron printer, ... 1.2.2 2 ee se ee banner(6) 
mm: printmame list. 2... 0. 1 1 ww ee ew te te te te ww nm(1) 
hostname: set or print name of current host sysiem. . .. 2-2 + 2 ee ee hostname(1) 
printenv: print outthe environment. . 2... 6 6 6 ee ee ee ee printenv(1) 
man: find manual information by keywords; printoutthe manual. ... 2... 6 ee ee ee eee man(1) 
pstat: print systemfacts. ..... Said: eae, ae WR ime Ba pstat(8) 
pagesize: print system page size. =. 6 2 1 ee ee ee ee tw pagesize(1) 
yes: printtextrepeatedly, 2... 2. 2 ee ee ee eee ene 1) 
atq: print the queue of jobs waitingtoberun. .........- atq(1) 
diction, explain: print wordy sentences; thesaurus fordiction. ........ diction(1) 
file. strings: find the printable strings in a object, or otherbinary, .....-... strings(1) 
printcap: printer capability database. ......-- 2... printcap(5) 
vip: Format Lisp programs to be printed with nroff, vtroff,ortroff. . 2... . + ee ees vip(1) 
'  printenv: print out the environment... en ee ae printenv(1) 
banner: printlarge banneron printer. . 2... 6 6 2 ee ee ee ee ee we oe ew ow © 6anner6) 
Ip:line printer, 2. 2 6 ee ee ee ew ee ee we we oe ww we NP) 
printcap: printer capability database. . . . 2... + + 6 + + © « ~ printcap(S) 
Ipc: line printercontrol program. ...... a Ipe(8) 
Ipd: line printerdaemon,. .. 1. 16 wee eee tt ee ewes ipd(8) 
Iprm: remove jobs from the line printer spooling queue. 9... 2. 6 6 ee eee ee ew ee Iprm(1) 
pac: printer/plotter accounting information. .......... pac(8) 
conversion. printf, fprintf, sprintf: formatted output... ....... printf(3S) 
setpriority: get/set program scheduling priority. getpriority, .... 2... 2+ eee ee eae getpriority(2) 
nice: set program priority, 2... 2. 2 ee ee eee we ee eee ew ne nice(3C) 
nice, nohup: run a command atlow priority(s Wh only), . 2.2... 2 eee ee ew ee wee nice(1) 
renice: alter priority of running processes. 2. 2. 6 6 6 0 ee ee ee renice(8) 
nice: run low priority process. . 2. 6 6 6 we ee ee te et te tw ww esh(1) 
highpri: make the current process ahigh priority process. ........ ee ae ae ee ae highpri(2) 
normalpri: make the current process a normal priority process. a ie ihe oo) a a eine aS normalpri(2) 
adduser: aerate adding new users. Ooo Sey we, 8 6a ee adduser(8) 
reboot: UNIX bootstrapping procedures. . ........0.. Ody eat ay Se ete, wee reboot(8) 
nice: run low priority process. . 2... 2s se ee ee ee ee we ee enn esh(1) 
stop: haltajobor process, 6 6 6 ee ee ee ee te te ee we ee we esh(1) 
_exit: terminate a process. PARE tog SS eee a ee ee era ae exit(2) 
fork: createanew process. ..... oN oe. Bls@e hie) “Sete a) ee ey ahs ae Si te fork(2) 
fork: create a copy ofthis process. 2 2. 6. 2 ee ee ee ww ete ww ew ew fork(3F) 
highpri: make the current process a high priority process. 2. 2... 2 0 ee eee eee eee eevee highpni(2) 
implogd: IMP logger process. .. 1... + ee ee WiscietecOA Te. fe clare Coes re implogd(8C) 
kill: send signaltoa process. 6 6 6 eee ee ee ew te te tt we es kill(2) 
kill: send a signal toa process. 2... 6 6 6 6 ew we ee ee ee wee we kill(3F) 
make the current process a normal priority process. normalpri Cee he eee eal ee eels nomnalpri(2) 
popen, pclose: initiate /O to/ffroma process. . 2. 2. 6 2 0 ee ew eee eee eee et popen(3) 
punlock: unlock the current process. ........ Pe eo ee a ee ee puniock(2) 
wait: await completion of process. 2 Sie Gs evi. Sar Oh, SE a SS wait(1) 
highpri: make the current process a high priority process. gate a Sew, Bice highpri(2) 
normalpri: make the current process a normal priority process. . ........2.02. normalpri(2) 
exit: terminate a process after flushing any pending pater a Ba ae exit(3) 
init: process control initialization. .......-.-2-+se6- init(8) 
getpgrp: get processgroup. 2... 0. eee tt te tt et es getperp(2) 
killpg: send signal toa processgroup. .... . . ee ee es ee killpg(2) 
killpg: terminate all members ofa processgroup. . 2. 6 2 2 6 ee ee ee eee ee ews killpg(8) 
setpgrp: set process group vie bs ek GT prw Pese tate’ Raha setperp(2) 
getpid: get processid. ..... be geena te Geo wih ep ere ar aes wo getpid(3F) 
getpid, getppid: get processidentification .. . 2... 2... 2 ee ee ees getpid(2) 
vfork: spawn new process in a virtual memory efficient WRY:. eo Seo ee ne vfork(2) 
plock: lock the current processincore. 2... 6 6 ee eee eee een ene plock(2) 
onintr: process interrupts in command Scripts. ewes ee we an esh(1) 
ps: processstatus. 2. 2. ee ee ee ee ee ee we we ns ps(1) 
times: get processtimes. ..........2. oie. te Beg lay & 8 times(3C) 
phys: allows a process to access physical addresses. . 2... 2... ~~. phys(3C) 
wait, wait3: wait for processtoterminate. ....... i <ehieihoa: eiviene wait(2) 
wait: wait fora process to terminate. ‘ eter ii Meo cah. fee Tare wait(3F) 
ptrace: processtrace. 6 6. 2 6 ee ee we ee we ew ewe ee ptrace(2) 
kill: terminate a process with extreme prejudice. F Stet te Se metre ei) kill(1) 
exit: terminate process with status. . 2. 2. 6 ee ee ee ee we ee exit(3F) 
kill: kill jobs and processes. 60. 6 6 ee ee te ee we we te es esh(1) 
gcore: get core images of running processes. 6 2 6 6 eee ee et tt we te eee es gcore(1) 
renice: alter priority of running processes. 6 2... 6 eee ee ee ee we we we ee es renice(8) 
wait: wait for background processes to complete By are, es eee fe eet vat Soe ee a ele esh(1) 
awk: pattern scanning and processing language. ... 2... 2 2 e+ see ee eae awk(1) 
cp: Intelligent Communications Processor. . . 2. 6 ss ee ee ee ee we we ene cp(4i) 
halt: stopthe processor, 6 6 6 6 et tw ee te ee ee we ee hait(8) 
m4: macro processor, 6 6 we ee te et et tt ew ee ee m4(1) 
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reboot: reboot system orhalt processor, 6 we ee et eee ee eee eee es 
prof: display profile data. ... 2... 2 eee ees - . prof(1) 
profil: execution time profile. . 2... 2.6 + ee ee eee profil(2) 
monitor, monstartup, moncontrol: prepare execution profile. . 2... 6 ee ee ee eee eee ree - monitor(3) 
profil: executiontime profile. 2... 2 2 6 ee ee ee eee eee ween profil(2) 
kgmon: generate a dump of the operating system’s profile buffers. . .......+.+- oe ee ee ee a kgmon(8) 
gprof: display call graph profiledata. .... ‘ Siete on ier Me - gprof(1) 
prof: display profiledata . 2... 61 2 2 ee eee ee we eee ee prof(1) 
drtest: standalone disktest program. . . 2. 2. 2 2 6 eee ee ee eee eee ne drtest(8) 
end, etext, edata: last locations in program. .......+..-. cg ieee Sale rai end(3) 
finger: user information lookup program. ..... . Gate 81g Lali Se oph ae finger(1) 
ftp: ARPANET file transfer program. ....- 2.5. + ee gore: eel aes ftp(1C) 
liszt: compile a Franz Lisp program. ...... ee ee are ee ee liszt(1) 
Ipc: line printer control program. .... . Sod a OR Now S: Sp eee a see Ipe(8) 
Ipq: spool queue examination program. .....- +. ++ se-e ee ee ae ee Ipq(1) 
Ixref: lisp cross reference program. ... 2.2 2 ee eee cee eee eee . Lxref(1) 
R msgs: system messages and junk mail program. ... 2. 2. 2 eee eee eee ee oe oe + 6mBgs(]) 
mt: magnetic tape manipulating program. .. 2... 6-2 eee ee ee ee ee oe oe © mth) 
pxref: Pascal cross-reference program. .. - 2. se ee ee ee ee ee eee ee paref(l) 
rdist: remote file distribution program. .. 2.6 22 6 eee eee eee ee wo MMist(l) 
tftp: trivial file transfer program. . . 2. 2. 2. 2 2 ee ee eee eee eee ene tfip(1C) 
timedc: timed control program. . . 2... 2 eee ee ee eee ee eee timedc(8) 
units: conversion program. .. 2... 2 ee eee ee ee ee ee ee units(1) 
whereis: locate source, binary, and or mamualfor program. .....- 0-2 ee eee eee eens . Whereis(1) 
cb:C programbeautifier, . 2... 2 6 ee ee ee ee ee cb(1) 
only). which: locate a program file including aliasesand paths(c sh ...... which(1) 
make: maintain programgroups. .. 2... eee eee eee ee eee make(1) 
nice: set program priority. oe Tene lorie’ HR Seba, “db ne.  wire ASS nice(3C) 
getpriority, setpriority: get/set program scheduling priority. .. 2... + 22s ee eee getpriority(2) 
indent: indent andformatC programsource. ....... St at So, Yet, “eh tar ye eee toca indent(1) 
assert: program verification. ai Festa) ely &: coho. tet, fester et Te Marten v6 assert(3) 
assert: program verification. . 2. 2. 2 2 2 ee ee ee eee assert(3X) 
lint:aC programverifier, 2... 6 2 ee ee ee et ee es lint(1) 
lex: generator of lexical analysis programs. .. 2.2. + 2 se eee eee eee enene lex(1) 
struct: structure Fortran programs. .. . se Serie. ve) ita Velveeta setae aes ce struct(1) 
vgrind: grind nice listings of programs. .... 2-6 + eee eee ec ee eens vgrind(1) 
troff. vip: Format Lisp programs to be printed with nroff, viroff,or ........ vip(1) 
xstr: extract strings from C programs to implement shared strings. .. . ..-.. 2+ xstr(1) 
arp: Address Resolution Protocol, . 2... 2 ee ee ee ee ee we wees arp(4P) 
ip: Internet Protocol. 2 2. 6 6 6 ee ee ee ee et ee ee es ip(4P) 
tcp: Internet Transmission Control Protocol. ..... ; Sa eed ee ar cad ee eG ay tep(4P) 
telnet: user interface to the TELNET protocol. Bah dy SE Wael carey fo Heeler et Groot dee eae ek telnet(1C) 
XNSrouted: NS Routing Information Protocol daemon. et teicor. er 8) rare, Care: eS tere es 0 Sir wicls XNSrouted(8C) 
getprotobyname, setprotoent, endprotoent: get protocol entry. getprotoent, getprotobynumber, wie - getprotoent(3N) 
inet: Internet protocol family. eo She te a ese eS. Bel GS, cae inet(4F) 
rmt: remote magtape protocol module. ......... Pe ere ee ee rmt(8C) 
protocols: protocol name data base. oe ee eee oe ee ee protocols(5) 
ftpd: DARPA Internet File Transfer Protocol server. 2. 2 6 5 0 we eee ee eee ene ftpd(8C) 
telnetd: DARPA TELNET protocol server, 2. 6 2 6 0 ee eee ee ew te eee telnetd(8C) 
tftpd: DARPA Trivial File Transfer Protocol server. 2. 2. 2. 2 eee ee ee ee ee eee tftpd(8C) 
trpt: transliterate protocol trace. 2... 2 2 ee ee eee we we ee ww trpt(8C) 
trsp: transliterate sequenced packet protocol trace. 2... 6 6 2 ee ee ee ee ewe es trsp(8C) 
protocols: protocol name database, a at Sia ae ceeten WS 8(5) 
mkproto: constructa prototype file sysiem. .. 2... 2 2 2 ee ee eee ee mkproto(8) 
lockf: provide advisory record locking « on files. ee ee ae ee ae lockf(2) 
arithmetic: provide drill in numberfacts. . 2... 2... 2. ee eee arithmetic(6) 
false, true: provide truth values Boe ae tac a ak ee Ss false(1) 
true, false: provide truth values. ...... Ble eta ee es eg, las ese true(1) 
pS: process status. 9. 6 ww ew we et te tt et ps(1) 
sp: disk spanning peeudodiskdriver, 2... 2. ee ee ee eee eens sp(4i) 
ply: peeudoterminal driver, 2... 6 2 2 ee ee ee eee pty(4) 
psignal, sys siglist: system signal messages. ...... . . psignal(3) 
petat: print system facts. 2... 2 6. 6 1 ee we eo potat(s) 
doctor: interact witha psychoanalyst. 2.2... 2 1 ee ee ee ee ew ww ee <Goctorl6) 
pirace: processtrace. 2.2 2 eee ee eo ee ee ptrace(2) 
px: permuted index, 6 ww ww ee ee et ee pex(1) 
pty: pseudo terminal driver. ..... Se gs ee ewe ce pty(4) 
punlock: unlock the current process. 2... 1.2.5. ..00- punlock(2) 
ungetc: push characterback into input stream. ........2.. ungetc(3S) 
pushd: push shell directory stack, 2... 6 2 ee eee ee eene csh(1) 
pushd: push shell directory stack . . 5-1 6 ee ees esh(1) 
puts, fputs: puta stringonastreaam. .. . 2.2. 2 22 eee ew eas puts(3S) 
putc, putchar, fputc, putw: put characteror wordona stream. .. . coe ee eo © putc(3S) 
unit. putc, fputc: write a character to a fortran logical oP sah Oa. Be se putc(3F) 
on a stream. putc, putchar, fputc, putw: put characterorword ...... putc(3S) 
stream. putc, putchar, fputc, putw: put characterorwordona .... . . putc(3S) 
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puts, fputs: puta stringonastreaam. 2... 26-2 ee ee puts(3S) 
putc, putchar, fputc, putw: put characteror word onastream. .. 2... 5 es putc(3S) 
pwd: working directoryname. . 2.2 2 2 se ee eee pwd(1) 
pxref: Pascal cross-reference program. . . . 6+ 2s ees pxref(1) 
qsort: quick sort. 2 6 6 1 ee te te te te et es qsort(3F) 
qsort: quicker sort. Se wie e Soe Hee Side -uen el teres us qsort(3) 
insque, remque: insert/remove element froma queue. . 2... 2. ee ee eee eee ee eres insque(3) 
Iprm: remove jobs from the line printer spooling queue. ...... oa Be See SO Ree, ee Iprm(1) 
uuq: examine or manipulate the uucp queue. . 2... 2. ee ee eee ee tte tees wuq(1C) 
Ipq: spool queue examination program. .. . . oe ee ee - Ipq(l) 
atq: print the queue of jobs waitingtoberun. .. . ce eee os BtQ(l) 
uucico, uucpd: transfer files queued by uucporuux. .. 2.2. 26 22s 2 ee eee wucico(8C) 
qsort: quick sor. 6 6 we ee ee ee ee we ee ee es qsort(3F) 
qsort: quickersort. . ... . SS phat glee te oe ee 6 e © Qsort(3) 
quiz: test your knowledge. ie 6 ele a ere le Se quiz(6) 
quot: summarize file system ownership. Unies ak Se: aS quot(8) 
quotacheck: check file system quota consistency. . 2... 2 2 eee eee . + + quotacheck(8) 
quota: display disk usage and limits. oe ee ee ew we © Quota(l) 
quota: manipulate disk quotas. ..... +--+ ++ + + - quota(2) 
quotacheck: check file system quota consistency. » + « « quotacheck(8) 
quotaon, quotaoff: tum file system quotasonandoff. ...... + » quotaon(8) 
off. quotaon, quotaoff: turn file system quotasonand ...... quotaon(8) 
edquota: edituser quotas. ..... bee et Rx Ge Sen eS a ee edquota(8) 
quota: manipulate disk quotas... 2... 0. a ae 9d ae “et a es Be quota(2) 
Tepquota: summarize quotas forafilesysiem. . 2... 2. 2-2 eee ee eee Tepquota(8) 
setquota: enable/disable quotasonafile system. .. 2... 6 6 ee ee ee eee setquota(2) 
quotaon, quotaoff: tum file system quotasonandoff. 2... 6 6 2 ee ee eee ee ee quotaon(8) 
Rgrep, Regrep, fgrep: searchafileforapatien. ........-., grep(1) 
patien. Rgrep,Regrep, fgrep:searchafilefora ........ grep(1) 
R msgs: system messages and junk mail program. ...... msgs(1) 
R mv: move or rename files. aia BAWSs Toned TAIPEI, ee 8! Hears mv(1) 
rain: animated raindrops display. .......+- - rain(6) 
rain: animated raindropsdisplay, . 2... 26 eee ee ee ee eee rain(6) 
rand, drand, irand: return random values. . 2... ee eee rand(3F) 
rand, srand: random number generator, . 2... 2... +. es rand(3C) 
generator. random, drandm, irandm: betterrandom number ...... random(3F) 
fortune: printa random, hopefully ee BONO. ig 5 a oe jo we fortune(6) 
ranlib: convert archivesto randomlibraries. 2... 2. 1 6 ee ee ee we ee eee ranlib(1) 
rand, srand: random number generator. ec One rat, Biles iene tie, MoS ee ee rand(3C) 
random, drandm, irandm: better random number generator, . . 2... 2 2 eee ee ew random(3F) 
random, srandom, initstate, setstate: better random number generator; routines for changing/ ...... random(3) 
number generator; routines for changing/ random, srandom, initstate, setstate: betterrandom ..... random(3) 
rand, drand, irand: return randomvalues. .. 2... 20 se ee eee ee aes rand(3F) 
ranlib: convert archives to random libraries. Wiciab here! datas fase ranlib(1) 
ratfor: rational Fortran dialect. . 2... 0. ee ee eee ratfor(1) 
ratfor: rational Fortran dialect. 2. 6.6. 1 we we wee ewww ratfor(1) 
alae command script for sho reicotund daemons. ob hia “sk 46 ro(8) 
stream to aremote command. rcmd, rresvport, ruserok: routines forreturninga ...... remd(3) 
stream to a remote command. rcomd, ruserok: routines for oe By a Go eee remd(3X) 
rep: remote file copy. . 2. 20 2 eee ee ee eee rep(1C) 
rdist: remote file distribution program. be er es dor fos fem Gittins rdist(1) 
rdump: file system dump across the network. ........ rdump(8C) 
getpass: reada password. . 2. 6 1 ee ee ee ee we we getpass(3) 
source: read commands fromfile. .. 2... 2 se ee eee ee esh(1) 
read,readv: readinput 2 2 2 1 eee ee ee ew we we ewww read(2) 
/continue, cd, eval, exec, exit, export, login, read, readonly, set, shift, ‘times, trap, umask, OMS See # sh(1) 
read, readv:readinput 2. 2 2 we ee ew et ee read(2) 
readlink: read value ofasymboliclink .........00608- . readlink(2) 
directory operations. opendir, readdir, telidir, seekdir, rewinddir, closedir; ........ directory(3) 
open: open a file for reading or writing, orcreateanewfile. 2... .....-6. n(2) 
, readlink: read value of asymboliclink, .......2... readlink(2) 
command/ /cd, eval, exec, exit, export, login, read, readonly, set, shift, times, trap, umask, wait: . . . . sh(1) 
read, readv:readinput. . .... ae ae a ee ee ee read(2) 
bad144: read/write dec standard 144 bad sector information. . . . badl44(8) 
Iseek: move read/write pointer, 2 2. 2 6 0 0 0 ee we ww eww  BseeK(2) 
setregid: set realandeffectivegroupID. ...........008-. setregid(2) 
setreuid: set real and effective userID’s. .. Bebe ae as. Sa ae Soret ee setreuid(2) 
malloc, free, realloc, calloc, alloca: ues allocator. Siete. 6 Serna eeet malloc(3) 
symorder: reafrangename list. 2... 2 2 2 ee ee ee ww teens symorder(1) 
reboot: reboot system or halt processor. oa ew ® Ae reboot(2) 
reboot: reboot system orhalt processor, . 6... 2 6 6 ee wees redoot(2) 
reboot: UNIX bootstrapping procedures. ......... redoot(8) 
fastboot, fasthalt: reboot/halt the system without checking the disks. . « fastboot(8) 
newaliases: rebuild the data base forthe mailaliasesfile. ........ newaliases(1) 
recv, recvfrom, recvmsg: receive a message fromasocket. . 2... 2... 2.004 recv(2) 
mail:sendand receivemail, .. 2... 0.2 eee eee we wwe eens mail(1) 
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binmail: send or receive mail among users. 2... 1... ee ee ee ee binmail(1) 
rmail: handle remote mail received viauucp. .... Sere: er “eh 8 rmail(1) 
re_comp, re_exec: regular expression ‘handler. err regex(3) 
rehash: reco command hashtable. .. 0... ee eee esh(1) 
lockf: provide advisory recordlockingonfiles. . 5... 1. 22 eee ee eee lockf(2) 
utmp, wimp: login records. ........ ds lees aire ina ee we cen Sy Sh utmp(5) 
socket. recv, recvfrom, recvmsg: receivea message froma ..... recv(2) 
recv, recvfrom, recvmsg: receive a message from a socket. recv(2) 
recv, recvfrom, recvmsg: receive a message from a socket. . .. 2... +s - recv(2) 
eval: re-evaluate shell data. 2... 2... 1 ee ee wens : csh(1) 
Te_comp, re_exec: re; ionhandler, . 2... 5. 2 se eee regex (3) 
documents. refer: find and insert literature referencesin ........ refer(1) 
Lxref: lisp cross reference 5 foe agi e es ele) te eaten We ei wk oP wine ixref(1) 
build inverted index for a bibliography, find references in a bibliography. indxbib, lookbib:_ Seen eter teres lookbib(1) 
refer: find and insert literature referencesin documents. ... 2... 2.2 eee ee eee refer(1) 
re_comp, re_exec: regularexpressionhandler. ..... . gale. Gh ihe We Soe regex(3) 
rehash: recompute command hash table. oe a . esh(1) 
comm: selector reject lines common to two sorted files. ...-.. 2. ss » comm(1) 
lorder: find ordering relation for an object library, . . 2... + + + + « + + « + border(l) 
join: relational database operator, . 2... 6 + 2s ee ee ] join(l) 
sigpause: atomically release blocked signals and wait forinterrupt. ....... sigpause(2) 
strip: remove symbols and relocation bits. .. 2... 622 eee eee eige ae . strip(1) 
copysign, drem, finite, logb, scalb: copysign, remainder, exponent manipulations. .........+ +s 
leave: remind you when youhavetoleave. .. 2... 5 2 eee. leave(1) 
calendar: reminder service. ...... eNigh te vei cee vs: Cet te weisel tes cea ce calendar(1) 
ruserok: routines for returning a stream toa remote command. remd,rresvport, .....-...-+.- remd(3) 
ruserok: routines for returning a stream toa remote command. romd,rresvport, ... 2... 2 ee remd(3X) 
rexec: retum streamtoa remotecommand. .... 2... 2. 22 ee ee ewes rexec(3) 
rexec: return streamtoa remotecommand. ........ Oh Sir Sica’ iwi tarde ler ve rexec(3X) 
L.cmds: UUCP remote command permissions POs se hee or ce eas SA L.cmds(5) 
rexecd: remote execution server. 2... 2 2 2 0 ee ew ew te ws rexecd(8C) 
fep: remote filecopy. .....-.2.e- a eee ee rep(1C) 
rdist: remote file distribution program. .........-.. rdist(1) 
uusend: send a filetoa remotehost. . ... 2... 2 ee eee te te ee es uusend(1C) 
L.sys: UUCP remote host descriptionfile. ... 1... 2.2 2. ese ee L.sys(5) 
remote: remote host descriptionfile. . 2... 2. 2.2 ee eee remote(5) 
phones: remote host phone number database. . .. 2... 2.2.2.4. phones(5) 
flogin: remotelogin, . 2... 2 2 ee ew we eee ww ewe rlogin(1C) 
rlogind: remote login server. . 2. 2. 2. 2 2 2 2 ee ee we ew we rlogind(8&C) 
tn3270: full-screen remote loginto IBM VM/CMS. ..........se8e6.5 tn3270(1) 
rmt: remote magtape protocol module. .........22-. rmt(8C) 
rmail: handle remote mail received viauucp. ........2-406+8 rmail(1) 
remote: remote host description file. .......-..246. remote(5) 
rsh: remoteshell, 2... 6 6 ee ee eee ewe wens rsh(1C) 
rshd: remote shell server. 2... 6 6 0 ww ee we we ew wees rshd(8C) 
tip, cu: connecttoa remote sysiem. .. . lee! We we: ae aos tip(1C) 
talkd: remote user communication server. @ acted io ener wel See, toe talkd(8C) 
fingerd: remote userinformation server. . .. 2... 2 2 ee eee fingerd(8C) 
uupoll: polla remote UUCP site. 2... 0. 2 eee ew we ewes wupoll(8C) 
unlink: removeadirectoryentry, . 2... 1.2. eee eevee unlink(3F) 
mmdir: removeadirectoryfile. . . 6... 2. ee eee eevee rmdir(2) 
unmount: removeafilesysiem. .. 2... 2.2.0 se ee ee eee unmount(2) 
unalias: removealiases, . 2... 6 0 ee eee we ee ew wee esh(1) 
flock: apply or remove an advisory lock on an open GIG. Ue wel eae SS flock(2) 
colrm: remove columns fromafile. .......620.0.0cee- colrm(1) 
unlink: remove directoryentry, .. 2... 2.2.2 see eevee unlink(2) 
unsetenv: remove environment variables. . .......242000s esh(1) 
unifdef: removeifdef'edlines. . 2... 5... 7 2 ee we eee ane unifdef(1) 
Iprm: remove jobs from the line printer spooling queue. . .... . Iprm(1) 
atrm: remove jobs spooled byat. 2... 6 1 2 eee eee atrm(1) 
deroff: remove nroff, troff, tbl and eqn constructs. ........ . deroff(1) 
unlimit: remove resource limitiations. ........2.2.2. +... csh(i) 
strip: remove symbols and relocation bits. 2... .....0085 strip(1) 
rmdir: remove (unlink) directories. .....-. 2.0088 . « Mmdir(1) 
mm, rmdir: remove (unlink) files or directories. . .......0e0-6 rm(1) 
insque, remque: insert/remove element fromaqueve. ....... insque(3) 
rename: renameafile. .... fe Brahe eG ee Bo Se lal rename(3F) 
rename: change the nameofafile. ............ rename(2) 
R mv: move or rename files. She YS raL Oe Seay Ses ee, wash: ac Za. ee aah mv(1) 
rename: renameafile. . 2... 2 1 1 ee ee we ee ww rename(3F) 
renice: alter priority of running processes. . ......2.. renice(8) 
fsck: file system consistency check andinteractive repair, 2... 2 ee eee tee eee wee ee ene fsck(8) 
trpfpe, fpecnt: trap and repair floating point faults. ...........0.06- trpfpe(3F) 
trapov: trap and repair floating point overflow. ...........008. trapov(3F) 
while: repeat commands conditionally, . 2... 1... eee ee csh(1) 
repeat: execute command repeatedly. ..........- esh(1) 
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uniq: report repeated linesinafile. . ...... a a eae uniq(1) 
repeat: execute command repeatedly, . 2... 1 1 ewe ee ee et te ws esh(1) 
yes: print text repeatedly, . 2... 2. 2 ee ee ee eee ee anes yes(1) 
status. nwstat— report Ethernet Packet Transmission Firmware er bee terre ies ve . mwstat(8) 
jostat: report /O statistics, 2 20 0 eee ee ee et ee ts iostat(1) 
uniq: report repeated lines ina file. . . ee a a ee uniq(1) 
sendbug: mail a system bug reportto 4bsd-bugs. 6 6 ww ee ee et tt te ee seadbug(1) 
vmstat: report virtual memory Statistics. 6. 1. 6 ee ee te ttt vmstat(1) 
bugfiler: file bug reports in folders automatically. ..... Babe et een ed bugfiler(8) 
fseek, fiell: reposition a fileonalogicalunit, .. 2... 6s ee eee feeek(3F) 
fseek, ftell, rewind: repositiona stream. . ... 2... 2 ee <3 fseek(3S) 
repquota: summarize quotas fora filesystem. ....... repquota(8) 
notify: request immediate notification, .. 2... 2 esse eee csh(1) 
lock: reserveaterminal. 2. 2... 1 6 0 ew ee ee ee wwe lock(1) 
res_mkquery, res_send, res init,dn_ comp, dn_ expand: resolverroutines. . ... .. resolver(3) 
dn_expand: resolver routines. res ; mkquery, res send, res _init,dn comp, .......- - resolver(3) 
arp: address resolution display and control. eee. Se ee ae cee wo: AEPCBC) 
arp: Address Resolution Protocol, . 2... 6 6 6 0 ee ee ee oe + MMp4P) 
resolver— resolver configuration file. . 2... 2. 6 6 e+ + + «© « © resolver(5) 
; resolver resolver configuration file. ...... + 2 ee + Fesolver(5) 
res_send, res init, dn_comp,dn_ expand: resolver routines. res_mkquery, .. 2... 2 ee ee eee resolver(3) 
getriimit, setriimit: control maximum sysiem resource consumption. . ... 2. ese o + ¢ + «6getrlimit(2) 
vlimit: control maximum system resource consumption. .... oc ee we ew ww oe 6VlimitGC) 
limit: alter per-process resource limitations. .. 2... ee ee eee eee ne csh(1) 
unlimit: remove resource limitiations. . . . 6... 6 ee ee ee - esh(1) 
getrusage: get information about resourceutilization. . 2... 6. 6 eee ee ee eee getrusage(2) 
vtimes: get information about resource utilization. . ..... Byte, Ge ah ie vtimes(3C) 
routines. res_mkquery, res_send, res_ init, dn_comp, dn “expand: resolver gS ees ea resolver(3) 
restore: incremental file system restore. 2. 2... 2 0 ee ee ee eee eer eee ee testore(8) 
trestore: restore a file system dump across the network. a el Se ere le rrestore(8C) 
restore: incremental file system restore. ...... +. > restore(8) 
suspend: suspend a shell, resuming its superior. .. . . cee e - esh(1) 
mset: retrieve ASCII to IBM 3270 keyboard map. iste dele? oe eS mset(1) 
getarg, iargc: return command line arguments. . . .. 2... 2-7 ee ee getarg(3F) 
fdate: return date and time in an ASCII string. . . 2... 2.2... fdate(3F) 
idate, itime: return date or time in numericalform. .........-. idate(3F) 
etime, dtime: return elapsed executiontime. .. 2... 2.22 ee eee etime(3F) 
fimin, fimax, ffrac, dfimin, dfimax, dffrac, inmax: returnextreme values. . 2... 1. 2 1 0 ee eee ee ws fimin(3F) 
sigreturn: returnfromsignal. . 2... 2. 2 2 2 ee eee ee eee sigreturn(2) 
vacation: return ‘‘] am on vacation’’ message. a iat a eS eae eS a aS vacation(1) 
rand, drand, irand: returnrandom values. ...... ses eee ee eee rand(3F) 
rexec: return streaamtoaremotecommand. .......-+ +20. rexec(3) 
rexec: return streamtoaremotecommand. .......-.... rexec(3X) 
time, Ctime, Itime, gmtime: returnsystemtime. ..... 2.26. ee ee ee eens time(3F) 
loc: return the address of an object. BY Boece le yes ire SoS be Me loc(3F) 
rcmd, rresvport, ruserok: routines for returning a streamtoaremotecommand. ......... remd(3) 
rcmd, rresvport, ruserok: routines for returning a streamtoaremotecommand. ......... romd(3X) 
rev: reverse linesofafile. 2... 2... eee ee eee rev(1) 
col: filter reverseline feeds. . 2... 2 se eee eee se eens col(1) 
rev: reverselinesofafile. . . . 2. 2. 2 see ge ie Vela “ok cere rev(1) 
lastcomm: show last commands executed in reverseorder,. . . . 2.6 2 2 ee gs elieizes CAP perwer 4a ‘: lastcomm(1) 
fseek, ftell, rewind: reposition a stream. So eclel Gas SS: SOS! ves Teena 4a? Be fseek(3S) 
opendir, readdir, telldir, seekdir, rewinddir, closedir: directory operations. 6 ee ore Bee wel’ directory (3) 
rexec: return streamtoaremotecommand. ........ rexec(3) 
rexec: return stream to aremote command. ........ rexec(3X) 
rexecd: remote execution server. . 2... 2 2 ee ee ee rexecd(8C) 
index, rindex, Inbink, len: tell about character objects. ....... index(3F) 
strcmp, strncmp, strcpy, strncpy, strien, index, rindex: string operations. strcat,simcat, .....2.2.2.-. string(3) 
round-to-nearest functions. fabs, floor, ceil, rint: absolute value, floor, ceiling,and .......2..-. floor(3M) 
Iptest: generate lineprinter ripple pattem. . 2... 2... 22 oe 8. cos Se) cs Iptest(1) 
rk: RK6-11/RKO06 and RKO7 moving head disk. arias » <C.)) 
hk: RK6-11/RK06 and RKO7 moving headdisk . . 2... 1 1 2 wee ee ees hk(4) 
rk: RK6-11/RK06 and RKO7 moving headdisk. . 2 2... 12 2 eee ee eee rk(4) 
hk: RK6-11/RK06 and RKO7 moving head disk. . . . « bk(4) 
tk: RK6-11/RK06 and RKO7 moving head disk ........ rk(4) 
rlogin: remote login. =. «2 2 0 se we ee we ee ww rlogin(1C) 
tlogind: remote login server. 2... 2 2 2 ee ee ee rlogind(8C) 
rm, rmdir: remove (unlink) files or directories. ee eee rm(1) 
rmail: handle remote mail received viauucp. ........ rmail(1) 
rmdir: remove adirectoryfile. . 2... 2.2. 2s ee eee rmdir(2) 
rmdir: remove (unlink) directories. . . 1... ee ee ae »  rmdir(1) 
rm, rmdir: remove (unlink) files or directories. . . 2... ...2.0- rm(1) 
mmt: remote magtape protocol module. ..... . . rmt(8C) 
robots: fight off villainous robots. . 2... 2. 6 ee eee ee eee eee r robots(6) 
robots: fight off villainous TODOS. 96 ww ee we te robots(6) 
roffbib: run off bibliographic database. . 2... ...200- roffbib(1) 
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cbrt, sqrt: cube root, square root. 

chroot: change 

chit, sqrt: cube 

ceil, rint: absolute value, floor, ceiling, and 


admin: perform 

inet_netof: Internet address manipulation 

ns_addr, ns_ntoa: Xerox NS(tm) address conversion 
res_send, res_init, dn_comp, dn expand: resolver 
tgoto, tputs: terminal independent operation 
setstate: better random number generator; 
command. rcmd, rresvport, ruserok: 

command. rcmd, rresvport, ruserok: 
routed: network 

XNSrouted: NS 

route: manually manipulate the 
mout,/ madd, msub, mult, mdiv, pow, gcd, invert, 
network. 
to a remote command. rcmd, 
to a remote command. rcmd, 


bit: and, or, xor, not, 
atq: print the queue of jobs waiting to be 
nice, nohup: 
nohup: 
nice: 
roffbib: 
gcore: get core images of 
renice: alter priority of 


remote command. remd, rresvport, 
remote command. rcmd, rresvport, 


rx: DEC 


savecore: 


brk, 
copysign, drem, finite, logb, 
scandir, alphasort: 


awk: pattern 
Subsystem). 
sccs: front end for 
alarm: 
ualarm: 
getpriority, setpriority: get/set program 
clear: clear terminal 
curses: 
ex. vi: 
Tc: command 


onintr: process interrupts in command 
sd: VME 


/min, omin, fmin, m_in, mout, omout, fmout, m_out, 
R grep, Regrep, fgrep: 
“xsend, xget, enroll”: 
bad144: read/write dec standard 144 bad 
badsect: create files to contain bad 


opendir, readdir, telidir, 
brk, sbrk: change data 


comm: 
case: 


uusend: 
send, sendto, sendmsg: 
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— Exploring The Dungeonsof Doom. . .......-. rogue(6) 

ef i bar ai. Bie Denese Wigs Be Ue. wie Cer See + + sqrt(3M) 
root directory. ..... . ee ae ee eras ee ees chroot(2) 
foot, square TOOL, 6 6 we we te te et es ‘ sqrt(3M) 
round-to-nearest functions. "fabs, flOOL;. <6: alee ards a Os floor(3M) 
route: manually manipulate the routing tables). . ...... route(8C) 
routed: network routing daemon. 6 eater ae IG: Oo ae Se routed(8C) 
routine system administration tasks automatically, ..... admin(8) 
routines. /inet_ntoa, inet_makeaddr, inet Inaof, ..... . inet(3N) 
routines. ..... o. % Go Fat ra "alte! Ser wl cat a> Norse Ke He ns(3N) 
Youtines. res mkquery, .......- is CRS Wee Gr Bi Sara resolver(3) 
routines. tgetent, tgetnum, igetflag, tgetstr, 2. 2. ee eee termcap(3X) 
routines for changing generators. /initstate, ......+.. random(3) 
routines for retuming a streaamtoaremote ......+.-. romd(3) 
routines for returning a streamtoaremote ........-. romd(3X) 
routingdaemon. .. 2.2.2 2 ee eee eee eee ee routed(8C) 
Routing Information Protocol daemon. oe ee ee oe © © XNSrouted(8C) 
fouting tables. 2. 2. 2 2 2 2 ee ee ee we te ww we ww = OUte(8C) 
pow, msqrt, mcmp, move, min, omin,fmin,m_in, ... . . mp(3X) 
trestore: restore a file system dump acrossthe ..... . . sestore(8C) 
fresvport, ruserok: routines for retuming a stream ...... remd(3) 

ruserok: routines for retuminga stream ...... romd(3X) 
teh: remoteshell, 2... 0 0 oe ew eee ee wee reh(1C) 
rehd: remote shell server.  . 2. 2... 2 2 2 eee : - frehd(8C) 
rshift, Ishift bitwise functions. .... 2... +6. ee ee bitGF) 
a atq(1) 
run @ command at low priority (s Ronly), ......2.. nice(1) 
run command immune tohangups. . .... 2... 2 see csh(1) 
run low priority process. . ......- Se Sa ee cesh(1) 
tun off bibliographic database. . . 2... 2 ee ee eee roffbib(1) 
running processes. . . 2 2 2 0 ae er ee ee gceore(1) 
Munning processes. 2 6 2 ee ee eet tt tt ew renice(8) 
ruptime: show host status of local machines. ........ Tuptime(1C) 
ruserok: routines for returninga streamtoa ........ romd(3) 
ruserok: routines for returningastreamtoa ......4.. remd(3X) 
rwho: who’s logged inon local machines. . .......-. twho(1C) 
rwhod: system status server, 2 2 6 1 0 ee ee te ees rwhod(8C) 
m: DEC RXO2 floppy disk interface. ........0.2.. ™(4) 
RX02 floppy disk interface. ..... we: a Se) Len ies Me ae 1™(4) 
rxformat: format floppy disks. Se goes ud? eh tes sae te) Hb rxformat(8V) 
Sa, accton: systemaccounting, .. 2... 2 ee ww eee sa(8) 
sail: multi-user wooden ships andironmen. ........ sail(6) 
save a core dump of the operating system. ......... savecore(8) 
savecore: save a core dump of the operating system. .... . savecore(8) 
sbrk: change data segment size. 2... 1 1 we we ee brk(2) 
scalb: copysign, remainder, exponent manipulations. . ieee(3M) 
scan a directory, ......+2... Oo fess'di sh Serle vee er 82 scandir(3) 
scandir, alphasort: scan a | directory. aviesker 6 g7s eet ee serdar te scandir(3) 
scanf, fscanf, sscanf: formatted input conversion. ...... scanf(3S) 
scanning and processing language. . .. 1... 2220s awk(1) 
secs: front end for SCCS (Source Code Control . . . 2... scecs(1) 
SCCS (Source Code Control Subsystem). ......... scecs(1) 
schedule signal after specifiedtime. .......2.224.. alarm(3C) 
schedule signal after specifiedtime. .........+.-. ualarm(3) 
scheduling priority, . 2... 21 eee eee ew ene getpriority(2) 
BCTOCN.. ce 8 oe ee eee 8 ee eee clear(1) 
screen functions with ‘‘optimal’’ cursor motion. ren Se ie curses(3X) 
screen oriented (visual) display editorbasedon ....... vi(1) 
script for auto-rebootanddaemons. .......2..2.-. rc(8) 
script: make typescript of terminal session. ......0.-. script(1) 
ll ai Me RON ee ee er ee eee esh(1) 
SCSI disk adaptor interface. a? fal Jos eRe Oe ee Se : sd(4) 
sd: VME SCSI disk adaptor interface. ee eee we ew ww BAS) 
sdiv, itom: multiple precision integer arithmetic. . ... . . mp(3X) 
searchafileforapatiem. ..... pan shie  ae cat gta ase grep(1) 
Secretmail, 2. 6 1 wet ttt wt we we te tts xsend(1) 
sectorinformation. . Se er ae oe ae ee oe bad 144(8) 
BOCIOTES oie: hae a 8 Rea WO we a So ne Bee. Os badsect(8) 
sed: streameditor, . 2... 2 2 ee eee ee ww eee sed(1) 
seekdir, rewinddir, closedir: directory operations. .... .. directory(3) 
segment size. 6 www we te tt tt tw ww brk(2) 
select or reject lines common to two sorted files. ...... comm(1) 
select: synchronous I/O multiplexing, .......2.22.. select(2) 
selectorinswitch .. 2... 2 2 eee ewe we wns csh(1) 
send a file toaremote host. . . 1... 6 6 es ee ew ewes uusend(1C) 
send a message from asockel. . 2... 2-2. 2 ee eee send(2) 
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kill: send a signaltoa process. 2... 2 2 0 ee ee te ee killGF) 
mail: send and receivemail. . . 2... 6 2 ee ee ee ee © © 6mail(l) 
ping: send ICMP ECHO REQUEST packets to network hosts. - ping(8) 
sendmail: send mail overthe internet. . . . . . . ger ie etal, tense ae ie sendmail(8) 
binmail: send or receive mail among users. . . .« eee ee © © ~Dinmail(1) 
socket. send, sendto, sendmsg: send a message from a oe ee ee © 68ENd(2) 
kill: send signaltoa process. . 0. 22 2 ee ee ee ee ee kill(2) 
killpg: send signal toa processgroup. .. 2... + 6s see eee killpg(2) 
sendbug: mail a system bug Feprt to Abad-bugs eke fei er force sendbug(1) 
aliases: aliases filefor sendmail. ..... . oe ee eo ew oe ow oc Mliases(5) 
sendmail: send mail over the inte eee ee ee ee + 6BONMMAIl(8) 
send, sendto, sendmsg: send a message froma socket. .... +. +s. send(2) 
send, sendto, sendmsg: send a message fromasocketl. .... . . send(2) 
diction, explain: print wordy sentences; thesaurus fordiction. ...... eee 6 © © © 6diction(1) 
trsp: transliterate sequenced packet protocol trace. . 2. 2. 2 2 2 ee ee ee trsp(8C) 
slattach: attach serial lines as network interfaces. . 2... 2 2 + 2 ee ee slattach(8C) 
comsat: biff server. 2... 2 0 eee ee ee ww tw ew ww we © © 6COMSat(8C) 
fingerd: remote user information server. . 2. 2.6 2 2 ee eee ee ee ee eo ow ow « fingerd(8C) 
ftpd: DARPA Internet File Transfer Protocol server, . 2. 2 ee ee ee ee ee ee we ew ew wo ftph(8C) 
named: Intemet domain mame server. . . 2 2 2 2 ee ee ee ee ee ee - » mamed(8) 
named: Internet domain name server. . . . 2. 2 ee ee ee oe Mesos . named(8&C) 
rexecd: remote execution server. . 2. 2. 6 2s ee ee ee we ee oases ee ee rexecd(8C) 
rlogind: remote login server, . 2. 2 0 2 ee ee ee ee we eww we wwe rlogind(8C) 
rshd: remote shell server. ..... eee Bg Ge: Ted eer le ssi, Hes wake rshd(8C) 
rwhod: system status server. 2 2. 6 6 0 ee ee ee ee ee ww ow ww « Fwhod(8C) 
talkd: remote user communication server. ...... cp Sanilac ah a ee a) talkd(8C) 
telnetd: DARPA TELNET protocol server, . 2... 2.2 + te ee ° eee a telnetd(8C) 
tftpd: DARPA Trivial File Transfer Protocol server. . 2. 2... 2 2 ee ais ta aA Ta tan toh WB, ag tftpd(8C) 
timed: time serverdaemon,. .. 1... 2 se eee eee ene ee timed(8) 
services: service name data base. ‘ * 8 P services(5) 
logout: end session. ..... Peg a ae ae ea ee ee ee ae ee csh(1) 
script: make typescript of terminal session. ..... a ae ae ee a . script(1) 
ascii: map of ASCII character set. 2. 2 26 eee eee eee we eer ere rene ascii(7) 
stty, gtty: set and get terminal state (defunct). peas Wet ab ew ee Stes stty(3C) 
sigstack: set and/or get signal stack context. . 2. 2 0 ee ee ees sigstack(2) 
set: change value of shell variable. . . 2... 2-2... esh(1) 
sigsetmask: set currentsignal mask, . . 2... 2.2 2 eee ee eee sigsetmask(2) 
umask: set file creation mode mask. ... 1.2 2 es ee eee umask(2) 
utime:: setfiletimes. 2... 2. 2 eee wwe ew we weve utime(3C) 
utimes: setfiletimes. . .. 1... 6 eee Sten eta, eu ei tose tana’ utimes(2) 
setgroups: set groupaccesslist. 2 2. 2 2 2 ewe ee we ew et es setgroups(2) 
apply: apply a command toa set of arguments. inte soy iets een as Zee wet. ate ly(1) 
getsockopt, setsockopt: get and set options on sockets. ee ee ee ee ee ee getsockopt(2) 
domainname: set or display name of current domain system. ....... domainname(1) 
hostid: set or print identifier of current host system. .......-.- hostid(1) 
hostname: set or print name of currenthost system. .......2.- hostname(1) 
setpgrp: set processgroup. . 2... 2. 2 2 eee ee ee eee setperp(2) 
nice: set program priority, 2. 2... 2 2 ee ee ew we ee ew ee nice(3C) 
setregid: set real andeffectivegroupID. .. 2.1.2... e562 es setregid(2) 
setreuid: set realandeffectiveuserID’s. . 2... 2. 2. ee ee eee setreuid(2) 
eval, exec, exit, export, login, read, readonly, set, shift, times, trap, umask, wait: corieand? [ee sh(1) 
getty: setterminal mode. . 2... 6 6. ee ee wee wenn getty(8) 
stty: setterminal options. ...... aia tat ieee" leh iol 6; “eke stty(1) 
tabs: setterminaltabs. ..... er Saree Saw: eG ee tabs(1) 
date: printand setthedale. ...... aerate: od. Sieh Se eve ten ten Sue. @ date(1) 
setuid, seteuid, setruid, setgid, setegid, setrgid: setuserandgroupID. ....-. - 2... .+ 2s...» setuid(3) 
setenv: set variable inenvironment. ... . eee ew oe ew we CBHI) 
astream. setbuf, setbuffer, setlinebuf: assign buffering (6 sae . setbuf(3S) 
stream. setbuf, setbuffer, setlinebuf: assign bufferingtoa ......... setbuf(3S) 
setuid, seteuid, setruid, setgid, setegid, setrgid: setuserand groupID. .......2... setuid(3) 
setenv: set variable in environment. ......... =. + csh(l) 
variables. getenv, setenv, unsetenv: manipulate environmental ...... . . getenv(3) 
user and group ID. setuid, seteuid, setruid, setgid, setegid, setrgid:set ....... =. setuid(3) 
entry. getfsent, getfsspec, getfsfile, getfstype, setfsent, endfsent: get file system descriptorfile ..... . . getfsent(3) 
entry. getfsent, getfsspec, getfsfile, getfstype, setfeent, endfsent: get filesystem descriptor file ....... getfsent(3X) 
setuid, seteuid, setruid, setgid, setegid, setrgid: set userandgroupID. ....... setuid(3) 
getgrent, getergid, getgrnam, setgrent, endgrent: get group fileentry, .........- getgrent(3) 
setgroups: set group access list. . . 2... ....0200-6 setgroups(2) 
gethostbyname, gethostbyaddr, gethostent, sethostent, endhostent: get network host entry. ee a ee gethostbyname(3N) 
host. gethostid, sethostid: get/set unique identifier of current . ....... gethostid(2) 
gethostname, sethostname: get/set name of currenthost. ......... gethostname(2) 
getitimer, setitimer: get/set value of intervaltimer. .........- getitimer(2) 
setjmp, longjmp: non-local goto. 9... 1... 2. ee eee setjmp(3) 
crypt, setkey,encrypt: DES encryption. ........0220- (3) 
setbuf, setbuffer, setlinebuf: assign bufferingtoastreaam. .........-. setbuf(3S) 
syslog, openlog, closelog, setlogmask: control sysiemlog. .........62028- syslog (3) 
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getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent: get network ~ oe eo oe ee ow oo $6getnetent(3N) 
setpgrp: set process group. a ee ee ee setpgrp(2) 
getpriority, setpriority: get/set program schedulin; priority. ....... getpriority(2) 
getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent: get protocolentry. ..... ¢ + + getprotoent(3N) 
entry. getpwent, getpwuid, getpwnam, setpwent, endpwent, setpwfile: get passwordfile ...... getpwent(3) 
getpwent, getpwuid, getpwnam, setpwent, endpwent, setpwfile: get password file entry. Glay DRS ae Nia ade. De ee eae getpwent(3) 
setquota: enable/disable quotas on a file system. ...... setquota(2) 
setregid: set real and effective groupID. ........ . setregid(2) 
setreuid: set real and effective userID’s. ........ . setreuid(2) 
setuid, seteuid, setruid, setgid, setegid, setrgid: setuserandgroupID. ......-+ +. eee setuid(3) 
consumption. getrlimit, setrlimit: control maximum system resource... 1. + se getriimit(2) 
group ID. setuid, seteuid, setruid, setgid, setegid, setrgid: set userand ........ setuid(3) 
getservent, getservbyport, getservbyname, setservent, endservent: get serviceentry, ......-+-- getservent(3N) 
getsockopt, setsockopt: get and set options on sockets. . ... 2... getsockopt(2) 
for changing/ random, srandom, initstate, setstate: better random number generator; routines .... . random(3) 
gettimeofday, settimeofday: get/setdateandtime. ...... - . . gettimeofday(2) 
getttyent, getttynam, setttyent, endttyent: get ttysfileentry, ........ =. - getttyent(3) 
set user and group ID. setuid, seteuid, setruid, setgid, setegid, setrgid: ...... . setuid(3) 
getusershell, rip aera SOO tad get legal user shells. oe + 6 + ©) 6getusershell(3) 
continue, cd, eval, ine taltcxpore logins sh, for, case, if, while, .,break, 2... 2.5 ese es Bhi(l) 
xstr: extract strings from C programsto implement shared strings, . 2... 6 2 ee ee ee eee ee eee xstr(1) 
exit: leave shell, 2... 2 ee eee wee ere eee ere ense csh(1) 
reh:remote shell, 1... 2 we ec eee ee ee eee we ew eee rah(1C) 
system: issuea shellcommand. .......22e 2c eees ee « « system(3) 
csh:a shell (command interpreter) with C-like syntax. ...... esh(1) 
eval: re-evaluate shelldata 2... 1. 0 1 ee ee wwe ee we ee ews esh(1) 
popd: pop shell directorystack, ......2..-. bictas terete aura" os ce csh(1) 
d: shell directory stack, . 2... 2. eee oe ee © 6CBh(1) 
alias: shell macros. 2... 1. 2 eee wee eee - . . esh(l) 
suspend: suspend a shell, resuming its superior, .. 2... 2 ee se eee ee cesh(1) 
tehd: remote shell server, 2. 6 0 0 ee ete ee te ew wt es rshd(8C) 
set: change value of shell variable, 2. 2... 1 0 2 ee wee eee evens esh(1) 
@: arithmeticon shell variables. . 2... 1 0 0 ee ee ee tt te ts esh(1) 
unset: discard sheli variables. . .. . a ae ee ee ee ee eT csh(1) 
exec: overlay shell with specified command. Srp swt jes BS Beis eel Ge ae csh(1) 
setusershell, endusershell: get legal user shells. getusershell, 2... 0... 2 ee eee eee ee getusershell(3) 
shift: manipulate argument list. . 2. 2... 2 2 1 eee ee esh(1) 
/exec, exit, export, login, read, readonly, set, shift, times, trap, umask, wait: command language. ... .. sh(1) 
sail: multi-user wooden shipsandironmen. ........ ee Se ee ee, sail(6) 
long, short: integer object conversion. .........-002. long(3F) 
groups: show groupmemberships. ... 2... .. 2.22200. groups(1) 
Tuptime: show host status of local machines. .......2.2-2.. ruptime(1C) 
uptime: show how long systemhasbeenup. ........... ime(1) 
lastcomm: show last commands executed in reverse order. . .. 2... lastcomm(1) 
netstat: show network status. 2... 6 6 we ee ew we ee ew netstat(1) 
uusnap: show snapshot of the UUCP system. .........-2.. uusnap(8C) 
construct a file. what: show what versions of object modules were usedto ..... what(1) 
shutdown: shut down part of a full-duplex connection ......2.. shutdown(2) 
shutdown: close down the system ata giventime. ...... shutdown(8) 
connection. shutdown: shut down part of a cao Meet el Bu pen cue, eke shutdown(2) 
sigblock: block signals. 2... 2. 1 ee eee ee ene sigblock(2) 
calls. siginterrupt: allow signals to interrupt system  . 2. we ee siginterrupt(3) 
JOgIN:: SIGN ON. was? Sr 0K ere ce, © Smee we Ee SS Jogin(1) 
pause: stop until signal, 2... 6 1 we ee ew eet we tee tte pause(3C) 
signal: change the action fora signal. .. 2... 2 ee eee eee eee een ane signal(3F) 
sigretum: return from signal. . . 1... 1 2 ee eee wee eee wee ae sigreturn(2) 
alarm: schedule signal after specified time. beer eles So a terres ar. ei bidet “us alarm(3C) 
ualarm: schedule signal after specifiedtime. .. ......02+62e20 ualarm(3) 
signal: change the action forasignal . .......06 signal(3F) 
signal: simplified software signal facilities. gh. se a Saree See ee ey tag é . - signal(3C) 
sigvec: software signal facilities. 2... 2. 6 2 ee ee eee eee es Bigvec(2) 
' sigsetmask: set current signalmask. . . . 2... 6 ee ee ee ee ww ww oe Sigsetmask(2) 
psignal, sys_siglist: system signal messages. .. . . ee eee ee ee psignal(3) 
signal: simplified software signal facilities. er oe eee eee signal(3C) 
sigstack: set and/or get signal stack context. 2 6 2 1 1 we we ee tt ts sigstack(2) 
kill: send signal to a process ee ee ae) eee ee a ee kill(2) 
kill: senda signal toaprocess. ..... $e ea? ee Bee aS asd kill(3F) 
killpg: send signaltoaprocessgroup. .......0.50+0 0020s killpg(2) 
sigblock: block signals.  . 2... 2 ee eee wee we ww wee sigblock(2) 
sigpause: atomically release blocked signals and wait forinterrupt. .......-.-2 5028506 sigpause(2) 
(temporary). infnan: signals invalid floating-point operationsona VAX ..... infnan(3M) 
siginterrupt: allow signals to interrupt systemcalls. 2... 6... 2 wwe ee siginterrupt(3) 
wait for interrupt. sigpause: atomically release blocked signalsand ...... sigpause(2) 
sigretum: return from signal. . 2... 0... eee es sigreturn(2) 
sigsetmask: set current signalmask, .........2.. sigsetmask(2) 
sigstack: set and/or get signal stack context. ......4.. sigstack(2) 
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sigvec: software signal facilities. ...... +++... sigvec(2) 
signal: simplified software signal facilities. . . . 2. + + eee signal(3C) 
te: photoypesetier simulator, . 2... 1... 2 ee eee owe we ee tefl) 
trigonometric functions and their inverses. sin, cos, tan, asin, acos,atan,atan2:  ...... — . sin(3M) 
sinh, cosh, tanh: hyperbolic functions. ... +--+ ++... sinh(3M) 
pull: data sink, 2... 1 1 we ee we we te we ves digs Reece oat Fe aull(4) 
uupoll: poll a remote UUCP site, 2... 6 2 eee ee eee ee ee we ee ee uupoll(8C) 
bork, sbrk: change data segment size. .... . Sieh fei sey ee ie, Bo ete - . brk(2) 
getdtablesize: get descriptortable size. . ......2.26. fags Maan bgt case Son Welt carves CSS getdtablesize(2) 
getpagesize: get system page size. 2. 2. 2 ee ee ee ee et we ee ee ew getpagesize(2) 
pagesize: print system page size. . 2... 2 2 ee ee ee te ew be a ar ee MS pagesize(1) 
size: sizeofanobjectfile. . 2... 2. 2. 2 ee ee ew eee ees size(1) 
size: size of an object file. ae Bieta) fr aia ate ae Safes size(1) 
diskpart: calculate default disk partition sizes. . 2... 2 eee eee rere eee ee vene diskpart(8) 
interfaces. slattach: attach serial lines as network Sock mbites, Jai faltelcedtes ‘ei slattach(8C) 
sleep: suspend execution for aninterval. ....-+-+..- sleep(1) 

_ sleep: suspend execution for an interval. ee a ee sleep(3F) 
sleep: suspend execution for interval. ......--. sleep(3) 
sm: VME SMD disk interface. .. 2... 2. 2 ees . sm(4) 

sm: VME SMD disk interface, . 2... 2 2 ee eee - sm(4) 
spline: interpolate smoothcurve. .. 2.2. 2-6 se ee ee eee oe spline(1G) 
snake, snscore: display chase game. a ee ee oe ee ee snake(6) 
uusnap: show snapshot of the UUCP sytem. 2. 2 2. 2 ee ee eee uusnap(8C) 
snake, snscore: ee Sor Bi Sate SW etal Yer eicce) dents snake(6) 
accept: accept aconnectionona socket. ..... bg Wariee eialec “Yoh Terie 96 Wewie® ser ene . accept(2) 
bind: bind a name toa socket - WG fas tyr tais a Ses ieeiel OS, vac: ve Wat fe a ay bind(2) 
connect: initiate a connection on a socket. Gs ge So. 2p Giniel Ae ax, wh Cerne) WO 8a : ae connect(2) 
listen: listen for connections ona socket. ...... Ge lse. “SPR ah Seite Leone a Soe wear listen(2) 
recy, recvfrom, recvmsg: receive a message froma socket. . ....-2 20. bide wien eee Mes -8 pal. ere ce recv(2) 
send, sendto, sendmsg: send a message froma socket. . . 2... 2 1 ee we eer eee er eevee send(2) 
socket: create an endpoint for communication. rare are er socket(2) 
getsockname: get socketmame. ...... So! ear ere er we. lca 6 getsockname(2) 
socketpair: create a pair of connected sockets. ee ae ee socketpair(2) 
getsockopt, setsockopt: get and setoptionson sockets. 2... 1 6 ee ee ee we we we we ew getsockopt(2) 
socketpair: create a pair of connected sockets. ..... 6g eR a ae a oe a Oe socketpair(2) 
soelim: eliminate .so’s from nroff input, 2 wee et ew soelim(1) 
lo: software loopback network interface. ... 2.5. -52-- lo(4) 
signal: simplified software signal facilities. . . 2... 6 6 2 eee ee eee signal(3C) 
sigvec: software signal facilities. 2. 2... 6 ee ee eee ene sigvec(2) 
canfield, cfscores: the solitaire card gamecanfield. 2... 2... 2 2 eee eee canfield(6) 
nw: Integrated Solutions, Inc., 10 Mb/s Ethemet controller. ........ nw(4i) 
qsort: quicker sort. . 2... 2. ee oe : BI se: er fees wie AO qsort(3) 
qsort: quick sort, 2... 2 2 ee ee eee ee eee wee eevee qsort(3F) 
tsort: topological sort, 6 6 2 ee ee ee te ee we ee et ee tsort(1) 
sortbib: sort bibliographic database. by (asda eh deo ee eis 6,0 es be Meee sortbib(1) 
sort: sortormergefiles. 2... 0 1 ew wee ee te ee ewe sort(1) 
sort: sortor merge files. 2. 2... 2 6 ew wee ee eee sort(1) 
sortbib: sort bibliographic database. . . 2... 2.2. 2 eee sortbib(1) 
comm: select or reject lines common totwo sortedfiles. . ..... Boe.5: Sips tars 18% jos Yat eter ial tet carne! <al ve comm(1) 
look: find lines ina sortedlist. 2... 66 se eee eee ee ae ere look(1) 
soelim: eliminate .so’s from nroff input. Sap? RES? Sis co Ses te VEO AS soelim(1) 
soelim: eliminate. so’s from nroffinpu. ........ oo eee wee wis soelim(1) 
indent: indent and format C program source. .......-. ee ee ee a ee ie indent(1) 
mkstr: create an error message file by massaging C source. ......... ie atlas Ghee & mkstr(1) 
whereis: locate source, binary, and or manual for program. asks fancier whey (ons whereis(1) 
sccs: front endfor SCCS (Source Code Control Subsystem). . ....... ; . secs(l) 
source: read commands fromfile. .......-+4200- esh(1) 
sp: disk spanning pseudo disk driver. . 2... 2. 2 ee ee sp(4i) 
line, circle, arc, move, cont, point, linemod, space, closep!: graphics interface. /erase,label, . . . . . . . plot(3X) 
- expand, unexpand: expand tabs to sp. and vice versa. ww we ee ee ee . +s . expand(1) 
spconfig: build spanned disk configuration files. . . .. . inate edt aris spconfig(8) 
sp: disk spanning pseudo disk driver. ee ee ee sp(4i) 
way. vfork: spawn new process in a virtual memory efficient . .. . . . vfork(2) 
spconfig: build spanned disk configuration files. .. . . spconfig(8) 
exec: overlay shell with specifiedcommand. . .. 2... 6 2 ee eee eee es cesh(1) 
truncate: truncate a filetoa specifiedlength, . 2. 2... 2 ee eee eee eee ae truncate(2) 
alarm: schedule signal after specifiedtime. ....... ee ee ee a ee ee alarm(3C) 
alarm: execute a subroutine aftera specifiedtime. . 2... 6. 2 ee eee eee we ee es alarm(3F) 
ualarm: schedule signal after specifiedtime. . . 2. 2. 2 6 eee eee ee ee wwe ualarm(3) 
swapon: specify additional device for paging and swapping. ..... swapon(8) 
spell, spellin, spellout: find spelling errors. ........ spell(1) 
spell, spellin, spellout: find spellingerrors. ...... 2. 2 ees spell(1) 
spell, spellin, spellout: find spelling errors. 2... 2 2 6 eee et te et et ws spell(1) 
spell, spellin, spellout: find spelling errors. 2... 2. 1 2 ee eee ee spell(1) 
spline: interpolate smooth curve. .. 2.6 6 + ee eee spline(1G) 
split: splitafile into pieces. © 2. 2. 2 ee ee tt te ws split(1) 
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files. fsplit: split a multi-routine Fortran file into individual ....... feplit(1) 
frexp, Idexp, modf: split into mantissa andexponent. . . .. - 2-2 eee ee frexp(3) 
split: split a file into pieces. 6 2 ww we ee et te es split(1) 
uuclean: uucp spool directoryclean-up. . 2... 2 2 ee ee ee wee uuclean(8C) 
Ipq: spool queue examination program. TL Ae RS OR, Go ae Ipq(1) 
atrm: remove jobs spooled by at. SE eee we ae ew atrm(1) 
Iprm: remove jobs from the line printer spooling queue. ......- ++ ses get NS antes Gite Iprm(1) 
printf, fprintf, sprintf: formatted output conversion. ... . +--+ s+ es printf(3S) 
cbrt, sqrt: cube root, square root. 2. 2. 6 2 2 ee ee ee ee sqrt(3M) 
chit, sqrt: cube root, squareroot. 2. 2. we eee te te tt tt es sqrt(3M) 
rand, srand: random number generator, . . 2... 2 2 + 2 ee ‘ rand(3C) 
generator, routines for changing/ random, srandom, initstate, setstate: betterrandom number ...... random(3) 
scanf, fscanf, sscanf: formatted input conversion. ...-.- +--+ +2 +s scanf(3S) 
stab: symbol table types. ee ee a ee ee ae stab(5) 
popd: pop shell directory stack, ..... o e. ee ee ee we © «CBHI 
pushd: push shell directory stack, ...... bas el re eer ee, ee ae ERG) 
sigstack: set and/or get signal stackcomtext. 2... 6 2 2 0 ee eee ee ee ew oo Bigstack(2) 
Grtest: standalone disk test program. . . . 2... 6 + + + + « © Grtest(8) 
bad144: read/write dec standard 144 bad sector information. .......... =. badl44(8) 
stdio: standard buffered input/output package. . . ... 1.6... intro(3S) 
stdio: standard buffered input/output aes ae OS ane Be ee stdio(3S) 
htable: convert NIC standard format host tables. os he 7 tes ten. eh ene wes eo tena htabie(8) 
stat, istat, fstat: get file status. 2 2 2 1 ee es stat(2) 
stat, Istat, fstat: get file status. 2... 01 ee ee ees stat(3F) 
stty, gtty: set and get terminal state (defunct). . 2... 2 2 0 ee eee we ee te tw ws stty(3C) 
fsync: synchronize a file’s in-core state with that on disk. nian So ukens 16 we RIMS Hex (0 far Ut Ser fete fsync(2) 
if: conditional statement. . . 2... 1 0 eee eet te te tw csh(1) 
fstab: static information about filesystems. .......-+... fstab(S) 
hashstat: print command hashing statistics. ...... aa ba 2s. ato, Mire Mer St @ Melee ees csh(1) 
iostat: report /O statistics. a 6 eS ee ae OR or a ee iostat(1) 
vmstat: report virtual memory statistics. ste eee fe < be Va fay ets xe Sire hairs vmstat(1) 
systat: display system statisticsonacrt 2... 2... ee ee ee we te ewe we systat(1) 
exit: terminate process with status. 2... 2. ee we ee wee ee et ew ew exit(3F) 
netstat: show network status. ... 2... 206 BD vei Wat elias feiesee Set ves. ibe tar ge MS netstat(1) 
report Ethernet Packet Transmission Firmware status. nwstali- ....... oy BS) aN eee! Giver art nwstat(8) 
ps: process status. 2 2. 2. 0 6 ew ee ee tt tw wt wt tw ps(1) 
stat, Istat, fstat: get file status. 2... 1 wwe ee ee we te et ee ts stat(2) 
stat, Istat, fstat: get file status. 2... we we we we et we we we ee ew ts stat(3F) 
ferror, feof, clearerr, fileno: stream statusinquiries. . 2. 2... 1... 0 ee eee ee eee ferror(3S) 
sysline: display system status on statuslineofaterminal, . . 2... 2.6 2 ee ee ewe sysline(1) 
Tuptime: show host status of local machines. . . 2. 2... 2 2 2 ee ee eee ruptime(1C) 
sysline: display system status on status line ofaterminal ........2.2.4.-. sysline(!) 
rwhod: system statusserver, 2. 2 2 ee eee eee eee eee we twhod(8C) 
stdio: standard buffered input/output package. ....... intro(3S) 
stdio: standard buffered input/output package. ....... stdio(3S) 
directories. sticky: persistent textand append-only ........4.. sticky(8) 
stop: halt a job or process. 2. 2... 2 ee eee ee ee esh(1) 
halt: stop the processor. . 2 2 2. 2 ew ee ee ee ee halt(8) 
use: stopuntilsignal. 2... 1. 2 eee ee ee ee es pause(3C) 
icheck: file system storage consistency check. . 2... 1... 6 ee ee eee icheck(8) 
subroutines. dbminit, fetch, store, delete, firstkey, nextkey:database ......... dbm(3X) 
strien, index, rindex: string operations. strcat, strncat, strcmp, strncmp, strcpy, stmcpy, ....... string(3) 
rindex: string operations. strcat, strncat, strcmp, strncmp, strcpy, strncpy, strien, index, ....... string(3) 
Operations. strcat, strncat, strcmp, stmcmp, strcpy, strncpy, strien, index, rindex: string ........ string (3) 
fclose, filush: close or flush a stream .......- Sy Bh ewe os Cote eae estes te nie es fclose(3S) 
fopen, freopen, fdopen: opena stream ....... ge Sark gears: ae ay Wes: oes ta fopen(3S) 
feeek, ftell, rewind: reposition a stream ...... Si pte We Br os. SE See Bae alee feeek(3S) 
getchar, fgetc, getw: get characterorword from stream getc, . 2... 1 2 eee eee eee we ene getc(3S) 
gets, fgets: get a string froma stream . 2... 1.2. 0 ee eee eee eer eee ene gets(3S) 
putchar, fputc, putw: put characteror wordona stream. putc, ......... esc a. ge Sele .  putc(3S) 
puts, fputs: putastringona stream. 2... 16 1 ee ee te ee ee ww eo puts(35S) 
setbuffer, setlinebuf: assign buffering toa stream. setbuf, ........ A eee ee ‘ setbuf(3S) 
ungetc: push character back into input stream. .. . 2.26 6 2 eee eee ee ee © «Ungetc(3S) 
sed: streameditor,. .. 1. 2... 2 0 se ee eo wn i as ee Were sed(1) 
ferror, feof, clearerr, fileno: stream status inquiries. ..... Be eo ee ec eS ee ferror(3S) 
remd, rresvport, ruserok: routines for retuming a streamtoaremotecommand. ..........2.ee-6 remd(3) 
remd, rresvport, ruserok: routines for retuming a streamtoaremotecommand. .......+6+ 22.0.8 romd(3X) 
rexec: return streamtoaremotecommand. ........62 2.2008 rexec(3) 
rexec:retum streamtoaremotecommand. ...........0.04.. rexec(3X) 
fdate: return date and time inan ASCH] string, . 2... 2 2 2 ee ee ee ew tee we ee fdate(3F) 
gets, fgets: geta stringfromastream ......-2.....2.20.2.004 gets(3S) 
puts, fputs: puta stringonastreaam .. 2... ...505020-0 2000s puts(3S) 
beopy, bcmp, bzero, fis: bit and byte string operations. . . . . : gs ee aw id Mls Se IS bstring(3) 
strcmp, strcpy, strncpy, strien, index, rindex: string operations. strcat, strncat, strcmp, DAES Waa CK Sas eet string(3) 
extract strings from C programs to implement shared strings. XStr; we ee ee ee xstr(1) 
other binary, file. strings: find the printable strings in a object, oe ee ana S strings(1) 
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strings. Xstr: extract strings from C programsto implement shared . . . ~~. xstr(1) 
strings: find the printable strings in a object, or other binary, file. ........2.-. strings(1) 
basename: strip filename affixes, 2... 0 2 1 ee eee ee wine basename(1) 
strip: remove symbols and relocation BHR. a. SA SP er we strip(1) 
strcat, strncat, strcmp, strcmp, strcpy, stmcpy, strlen, index, rindex: string operations. . . 2... +. ++ string(3) 
index, rindex: string operations. strcat, strncat, strcmp, strncmp, strcpy, stmcpy, strien, ....... string(3) 
string operations. strcat, strncat, strcmp, strcmp, strcpy, strncpy, strien, index, rindex: ..... . . string(3) 
sircat, strncat, strcmp, strncmp, strcpy, stmepy, strien, index, rindex: string cana eros eae string(3) 
, struct: structure Fortran programs. Whigs ace teh . + + struct(1) 
struct: structure Fortran programs. . 2... 2 ee ee ee +. struct(1) 
stty, gtty: set and get terminal state (defunct). see ee oe + StyGC) 
sity: set terminal options. 8. 2... 21s ee ee oe e © Btty(l) 
style: analyze writing style ofadocument. ........ . style(1) 
style: analyze writing styleofadocument. ... 2... 2.2 ee eee eee style(1) 
su: substitute user id temporarily, . 2... 2 6 2 eee ee su(1) 
alarm: execute a subroutine after a specified time a ee er ae . . . alarm(3F) 
fetch, store, delete, firstkey, nextkey: data base subroutines. dbminit, . . . . 2... 2 2 6 6 ee ee + + Gbm(3X) 
dbm_nextkey, dbm_error, dbm_clearerr: data base subroutines. /dbm_store, dbm_delete, dbm_firstkey, .. . . ndbm(3) 
1ib2648: subroutines for the HP 2648 graphicsterminal. ....... 1ib2648(3X) 
gu: substitute user id temporarily, . . 2... 2 2 2 ee ee ee su(1) 
sccs: front end for SCCS (Source Code Control stem). 2... 2. ee wee Kae 250s. ihe aca at Ze sccs(1) 
sum: sumandcount blocksinafile ..... 2-2-2. eee ee sum(1) 
sum: sum and count blocksinafile. .......2.-... sum(1) 
du: summarize diskusage. . 2... 2. 6 6 2 eo ee ee © © © Gull) 
quot: summarize file system ownership. . ....... + + + © quot(s) 
repquota: summarize quotas fora file sysiem. ...... =. +. « » repquota(8) 
sync: update the superblock. ..... be: oe Se Se Bre We ee eS sync(8) 
update: periodically update the superblock. ...... oe: et ae ee a eas update(8) 
sync: update super-block. . .......- a Sie Se aE ae eh eee sync(2) 
suspend: suspend a shell, resuming its superior, . . 2... 26 ee ee oe a ae ee eae csh(1) 
inetd: internet ‘‘super-server’. .... . ee ee ae ee ee eae inetd(8) 
intro: introduction to special files and hardware support. . 2... 2 2 2 ee ee ee te ee eee ee intro(4) 
suspend: suspend a shell, resuming its superior, 8. 2 2 1 ee ee ee esh(1) 
sleep: suspend execution foraninterval, . . 2.2.2 see ee sleep(1) 
sleep: suspend execution foraninterval, . ... 2.2 2 ee es sleep(3F) 
sleep: suspend execution forinterval, .....-.+-- . sleep(3) 
usleep: suspend execution forinterval . . 2... 2. 2 eee ee usleep(3) 
suspend: suspend a shell, resuming its superior. . ...... cesh(1) 
swab: swap bytes. ........ Srey ce Se as eee swab(3) 
swab: swapbytes. 2. 2. 2. 2 2 eee we ee ee ee ee swab(3) 
swapon: add a swap device for interieaved ee eae a swapon(2) 
paging/swapping. swapon: add a swap device forinterleaved ......... swapon(2) 
swapping. swapon: specify additional device for pagingand ...... swapon(8) 
swapon: specify additional device for paging and swapping. .... 2... 2 ee eee eee ee eee swapon(8) 
breaksw: exitfrom switch, . 2... 2 ee ee ee ee ew eee ee es esh(1) 
case: selectorin switch ... Soe een et Sere ve! ene yo Sex enh ws esh(1) 
default: catchall clause in switch, .......22-. SY Gelsve® cxtat tier ig: Soh der gis rots ete csh(1) 
endsw: terminate switch, . 2... 2 2 eee eee eee eee we ene cesh(1) 
switch: multi-way command branch. ead ie res SP ig Saket ae esh(1) 
dbx: dbx symbol table information. ...... gi cigs re tet Ghar. cies dbx(5) 
stab: symbol tabletypes. 2. 2 2. 2 1 2 ee ew ewe we ee ws stab(5) 
readlink: read value ofa symboliclink .......... wh fey oe OS ee oa Tene se readlink(2) 
symlink: make symboliclinktoafile. ...... be eee eike: Boe) @ Ve we symlink(2) 
strip: remove symbols and relocation bits. ... 2... 2. ee ee eee strip(1) 
symlink: make symbolic linktoafile. ..... 4... . + symiink(2) 
symorder: rearrange name list. ©. 2. 0. 1 1 0 ew we ee symorder(1) 
sync: update super-block, 3. 2... 2 1 2 wwe eee sync(2) 
sync: update the superblock ....... Sean ar ar an ae sync(8) 
adjtime: correct the time to allow synchronization of the systemclock, ........00- adjtime(2) 
disk. fsync: synchronize a file’s in-core state with thaton ........ fsync(2) 
select: synchronous I/O multiplexing, . . 2... 2... 2 ec eee select(2) 
csh: a shell (command interpreter) with C-like syntax, 2... 2. eee eee se eee were wen oe csh(1) 
L. sys: UUCP remote host description file. . . ....... =. Lesys(5) 
syscall: indirect systemcall.- 2... 1.1. 222. eee . syscall(2) 
perror, sys_errlist, sys_nerr: system error messages. . .....2.. perror(3) 
terminal. sysline: display system status on status lineofa ...... sysline(1) 
syslog: log systems messages. 8. 2 2 1 2 ww ete ew syslog(8) 
system log. syslog, openlog, closelog, setlogmask: control af wil ew, Te ace syslog(3) 
syslogd: log systems messages. ...... oes Nie. eel ae colts syslogd(8) 
perror, sys_errlist, sys_nerr: system error messages. 8. 2... 2... ee perror(3) 
psignal, sys_siglist: system signal messages. ........... psignal(3) 
systat: display system statisticsonacrt. ........26. systat(1) 
syslog: log systems messages. . 2. 6 0 5 ee ee ew wt we we we syslog(8) 
syslogd: log systems messages. 2. 2 6 2 2 ee eee ete ee en es syslogd(8) 
kgmon: generate a dump of the operating system’s profile buffers. . 2... 1. 2 eee ee eee kgmon(8) 
rehash: recompute command hash table. 2... 2 6 ee ee eee eee we te we ew es esh(1) 
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unhash: discard commandhash table. . 2... 1 eee ee ee . a Pies) et tao esh(1) 
mkhosts: generate hashed host table. etiie's oes ey eo tal tee 6 Me 8S as Ca at i ia Soe asin, 0h te mkhosts(8) 
mkpasswd: generate hashed password table. Gi fe aS ae tal ace, gem Se WR ee eee mkpasswd(8) 
/etc/mtab: mounted file system table. 2... 1 1 we ee ee ee ee eww ww ee mtab(5) 
vwidth: make troff width tableforafont . . 2... ee eee eee we we rene vwidth(1) 
dbx: dbx symbol table information. . .......56 00 ee ee eee dbx(5) 
getdtablesize: get descriptor table size. 2... 2 0 we ee tte tt ewe ee getdtablesize(2) 
stab: symbol table types. ais DoE ey ahd 2. isk Ue Gt hee Oh Cel eT wottae tat veal Cer Me stab(5) 
htable: convert NIC standard formathost tables. ......4.. bs Contec er carne ieee one. tarjeta) foe htable(8) 
route: manually manipulate the routing tables Boge Bees Tepa@ Tere a er ae ae ee route(8C) 
tbl: format tables for nroff ortroff. . 2... 6 2 ee we ew ee ws thl(1) 
gettable: get NIC format host tables fromahost. . 2... 2 2 0 ee eee ee eee gettable(8C) 
tabs: setterminal tabs. . . . 1... ee ee ee we ewe ee er ee tabs(1) 
tabs: setterminal tabs. . 2... 2... 2 2 2 ee nese Serer tabs(1) 
expand, unexpand: expand tabs to spaces, and vice versa. . 2. 2. 2. 6 2 2 ss ee ee expand(1) 
Ctags:createa tagsfile, 2... 21 ee we eee ee te we ew we ewe ctags(1) 
tail: deliver the last part of a file. 5 eS ewes enw: esis tail(1) 
talk: talkto anotheruser. 2 2 2. 6 6 1 2 2 ee eee ee talk(l) 
talk: talktoanotheruser. 2... 2 0 eee we we ww ew ew  talk(l) 
talkd: remote user communication server. oe eo ee «talkd(8C) 
functions and their inverses. sin, cos, tan, asin, acos, atan, atan2: trigonometric ae ee sin(3M) 
sinh, cosh, tanh: hyperbolic functions. ......+.+-+.-. + + ¢ « « sinhGM) 
tcopy:copyamag tape. 2... 6 ee ee ee ee ee www we ees tcopy(1) 
tp: manipulate tapearchive. ......-. A ee ee ee ee ee tp(1) 
tar: tape archive file format. . re ee ae ee ee eee tar(5) 
tar: tapearchiver, ....... BGS welts ese vas ere er oes Se tar(1) 
tp: DEC/mag tape formats. 6 oe Bale rhe % te are Se, od ae BGS as tp(5) 
tclose, tread, twrite, trewin, tskipf, tstate:f77 tape /O. topen, . 2... 2 2 ee ee ee ee ew oe topen(3F) 
mt: magnetic tape manipulating program. . . . 2. 2 2 2s ee eee mt(1) 
tar: tape archive file format. - i ale tet Bitoeet eee tar(5) 
tar. tape archiver, 2 6 06 6 wee ee et ew te ts tar(1) 
admin: perform routine system administration tasks automatically, . 2... 1. 0 1 ee eee we eee admin(8) 
deroff: remove nroff, troff, tbl and eqn constructs. . . 1... 6 ee eee ee ee ew deroff(1) 
tbl: format tables for nroff ortroff. . . . 2... .-.-2 20 thl(1) 
tc: photoypesetter simulator. . . 2... 2 2 2 eee eee tc(1) 
tape I/O. topen, tclose, tread, twrite, trewin, tskipf, tstate:f77 ........ topen(3F) 
tcopy: copyamagtape. 2... 2 6 ee ee ee ee eee tcopy(1) 
tcp: Internet Transmission Control Protocol. ......+.. tep(4P) 
tee: pipe Fitting. “ue dk ee woe Bw is St eer sl tee(1) 
tk: paginator forthe Tektronix4014. 2.1... 2.5. 2 ee we ee weve tk(1) 
last: indicate last logins of usersand teletypes. . 2. 2... 2 ee ee ewe we ee we wwe last(1) 
index, rindex, Inbink, len: tell about character objects. ai Hors fet so". Jel. Se SS Mee Se, sae ve wae les 8 index(3F) 
operations. opendir, readdir, telldir, seekdir, rewinddir, closedir: directory ........ directory (3) 
telnet: user interface to the TELNET protocol, . 2. 6.1 6 ee ew ew ee ee we teinet(1C) 
telnetd: DARPA TELNET protocol BOTVETS a. Me 5 a WR Se ew telnetd(8C) 
telnet: user interface to the TELNET protocol. eee le Spee telnet(1C) 
teinetd: DARPA TELNET protocol server. .... 2... telnetd(8C) 
su: substitute userid temporarily. ....... et 8 ele eee 3 Shien ene eae ele su(1) 
signals invalid floating-point operations ona VAX (temporary). infnan: . 2. 2... 2 eee ee ee eee infnan(3M) 
term: conventional names forterminals. . .......266- term(7) 
termcap: terminal capability database. ........2.. termcap(5) 
1ib2648: subroutines for the HP 2648 graphics terminal. oi ise 1b: sabcey, le: elec gn ee We wr Wo SR etek elie 1ib2648(3X) 
lock: reservea terminal. . . 2. 1. 1. 2 2 0 ee eee eee eee eae lock(1) 
sysline: display system status on status line of a terminal. Sf ie ag Marae, Taye ce eRe? “a nel (ans sbo46' b> ete sysline(1) 
ttyname, isatty, ttyslot: find name ofa terminal. . . 2... 1.4.6. 2 ee eee eee eevee ttyname(3) 
vhangup: virtually ‘‘hangup’’ the current control terminal. . 2... 1 6 1 ee ee ee we eee te es vhangup(2) 
worms: animate worms on a display terminal. 6 lar 8) vakcOv ie. ai es. Gon ee > Anette ae abe worms(6) 
termcap: terminal capability database. 2... 1 0 ewe eee ee termcap(5) 
getty: terminal configuration database. . .....20 02208 gettytab(5) 
terminal dependent initialization ......2.. es tset(1) 
pty: Bie terminal driver, 6 6 ww ee ee wt te te es - pty(4) 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation routines. ee ee ee termcap(3X) 
ttys: terminal initialization data. 2... 6.6 es ew ee we ww «MYS(S) 
tty: general terminal interface. 2... 2. 2 we eee eee . « « tty(4) 
getty: set terminalmode. . 2... 2 eee ee ee we eens getty(8) 
tty: get terminalname. . 2. 2 2. 2. 0 ee ecw ew ee te es tty(1) 
stty: set terminal options. . we Fe ia! ae Te 6, Heh oy eh eee stty(1) 
ttynam, isatty: find name of a terminal port. . ae aN cay OE eee, ae tae ttynam(3F) 
clear: clear terminal screen... 1 1 0 wee te ee ee ew www clear(1) 
script: make typescript of terminal session. . 2. 2.2. 2 6 2 eee ee ee eee script(1) 
stty, gtty: set and get terminal state (defunct), . 2. 2... 2. 1 wee ee eee stty(3C) 
tabs: set terminaltabs. . . 1. 2. 2s 0 ee ee ee we we wee tabs(1) 
term: conventional names for terminals. . vale Wenteey sea oi Pe wien aol a) Get angeles eens: Potts term(7) 
wait, wait3: wait for processto terminate. . 2... 2 2 ee ee ee wwe ewe . wait(2) 
wait: wait fora processto terminate. . 6... 2 2s 0 ee wee ee ew ew ws wait(3F) 
_exit: terminate a process. 2. 6 6 6 ee ee ee ee ee ee exit(2) 
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Output. exit: terminate a process after flushing any pending ...-.... exit(3) 
kill: terminate a process with extreme prejudice. .....-+... kill(1) 
killpg: terminate all members of a process group. .... +... killpg(8) 
endif: terminateconditional. . 2... 1 we ee ee et et tw esh(1) 
end: terminateloop. .... 2-6. ee eee eee ee eee csh(1) 
exit: terminate process with status. ..... be at Gee en tee el exit(3F) 
endsw: terminate switch. a bil hel sae eae eae ee « - csh(1) 
abort: abnormal termination. . Saat, fonlcetves fa2 te: Weyer 6. att ete vey eve abort(3F) 
test: condition command. ‘i is eto Be? ei test(1) 
Grtest: standalone disk test program. tere. ee cas eee es Bh Za Feud @o SP ee drtest(8) 
quiz: test your knowledge. asi ies "6 Soh at 6 Say Se Re OS See iz(6) 
sticky: persistent text and append-only directories. gi ae wiht ae ee ey Oe sticky(8) 
ed: texteditor, 2... ew we wee ee we ee ee ow ew © CMI) 
ex,edit: texteditor, . 2... 0 6 ew we te ww wwe we we ewe ex(1) 
fmt: simple text formatter. 2... 6 0 ee ee ee et ee we ew ns fmt(1) 
mroff: textformatting. . 2... 2. eee ee ee ee eee ene nroff(1) 
troff, nroff: text formatting and typesetting, ...... oe ee. troff(l) 
ms: text formatting macros. . . 2. 6 6 6 6 6 © eo ee ee + 6ms(7) 
yes: print textrepeatedly, 6 6 6 6 ee ee ee ee ee ee ew we esl) 
tftp: trivial file transfer Bae La ta ah St al he Sat tftp(1C) 
‘tftpd: DARPA Trivial File Transfer Protocol server. Oa ee tfipd(8C) 
terminal independent operation routines. tgetent, tgetnum, tgetflag, tgetstr, tgoto,tputs: ...... . termcap(3X) 
independent operation routines. tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal . . . . - - 2 + es termcap(3X) 
independent operation routines. tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal... . . . . termcap(3X) 
operation routines. tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent ........ « termcap(3X) 
routines. tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation ........ termcap(3X) 
acos, atan, atan2: trigonometric functions and their inverses. sin,cos,tan,asin, . . 2. 26 ese eee sin(3M) 
diction, explain: print wordy sentences; thesaurusfordiction, . 2... 2.2 2 ee eee ee eee diction(1) 
alarm: schedule signal after specified time. ete Ss Eye fa 8 os Martie a contin s footer eae erties Bec cg alarm(3C) 
alarm: execute a subroutine after a specified time. . SEE wel Ce) te Ok Bree ee ys alarm(3F) 
at: execute commands atalater time. ..... Bet ewe cle ke oars - at(1) 
etime, dtime: retum elapsed execution time. .......- . coe ee ae ee etime(3F) 
gettimeofday, settimeofday: get/set dateand time. ...... ee ae ee ee ee ee gettimeofday(2) 
shutdown: close down the system atagiven time. ....... oe fet Ge RU ay erica Steen ee shutdown(8) 
time, ftime: get date and time. — ; Drtnm te eh Pes Mel Sactigh sol te eel tebe: Ses time(3C) 
time, ctime, Itime, gmtime: return system time. F aacgias Mel Bi seccep wer Ce.Reriovtiey ine: cer enre time(3F) 
ualarm: schedule signal afterspecified time. .. 2... 2 eee eee eee eee ee eee ualarm(3) 
time: time acommand. ... 2... 0 0 see eee etree time(1) 
time: timecommand. .. 2... 6 0 ee ee ee eee we esh(1) 
time, ctime, ltime, gmtime: return system time. oe eo ee ee time(3F) 
time, ftime: get date and time. 8) ei he cer fer aes ele? wc ceme, time(3C) 
fdate: return date and time in an ASCII string. . 2... 22 2 2 ee ee ewe fdate(3F) 
idate, itime: retum date or time in mumericalform. ..... 2.26 ee eee ees idate(3F) 
profil: execution time profile. 2... 6 6 6 ee eee ee we te ee ewe profil(2) 
timed: time server daemon. ei oe eb Soo v8? Vel ST te eh oe Ae oe aa ee timed(8) 
time: time a command. BG) 2h ibe dee ee ee 48 of i teh 20): Soha time(1) 
time: time command. . 2... 6 6 0 ee te ee we ee ws csh(1) 
adjtime: correct the time to allow synchronization of the system clock. ..... adjtime(2) 
gmtime, asctime, timezone, tzset: convert date and time to ASCII. ctime,localtime, .. 2... 2.2. ee ee ctime(3) 
tzfile: time zone information. ..... 0.2022 se eevee tzfile(S) 
timedc: timed control program. .. 2... 2 ee eee ee ee timedc(8) 
timed: time serverdaemon. .... 1.6 2 ee ee eee timed(8) 
timedc: timed control program. baie Br iets. Gaze forts timedc(8) 
getitimer, setitimer: get/set value of interval timer. ee ee ee eee oe ae ae ae +. 6 « «getitimer(2) 
times: get process times. cow aetes oe ee ee ee ee times(3C) 
utime: set file times. BAe Jaci Ree aan ae ler ole Rein Te oe ar We es ered utime(3C) 
utimes: set file times. 0. 0. eee ee ee te ewe we ee we ews utimes(2) 
times: get process times. oe ee ec we ee, Oe, NER Je times(3C) 
exit, export, login, read, readonly, set, shift, times, trap, umask, wait: command language. /exec, . . . . . sh(1) 
ctime, localtime, gmtime, asctime, timezone, tzset: convert date andtime to ASCII. ...... ctime(3) 
tip, cu: connect to aremote sysem. 6 2 2 ww we. 2 + + tip(iC) 
tk: paginator for the Tektronix 4014... ......2.2.. tk(l) 
tm: TM-11/TE-10 magtape interface. . .......2. =. =. tm(4) 
tm: TM-11/TE-10 magtape interface. ......2.2.2.2. 2. . tm(4) 
3270: full-screen remote login to IBM VMICMS. ‘ 1n3270(1) 
isgraph, iscntrl, isascii, toupper, tolower, toascii: character classification macros. /isprint, ..... . ctype(3) 
popen, pclose: initiate /O to/from a eee ee re eae er ere ae popen(3) 
Asprint, isgraph, iscntri, isascii, toupper, tolower, toascii: character classification macros. ...... ctype(3) 
tstate: £77 tape YO. topen, tclose, tread, twrite, trewin, tskipf, ......... topen(3F) 
tsort: topological sort. 2 6 6 we ee te tt te eee wee tsort(1) 
touch: update date last modified ofafile. ......... touch(1) 
Aspunct, isprint, isgraph, iscntri, isascii, toupper, tolower, toascii: character classification) ...... ctype(3) 
tp: DEC/mag tape formats. ....... ps ea sla Biko ae tp(5) 
tp: manipulate tape archive. .........0..2.00-. tp(1) 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal independent operation routines. . . . . . . . termcap(3X) 
tr: translate characters. 6 6. 1 6 ww ee eet tte es tr(1) 
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ptrace: process trace. . 2... 2 2 eee ee ene MG -es sie ee RS ptrace(2) 
trpt: transliterate protocol trace, 6... 0 1 eee et es b. a Bi ati ae ee trpt(8C) 
tsp: transliterate sequenced packet protocol trace. ........ ie ee AS, A Bee go SS trsp(8C) 
goto:command transfer. 2... 2 1 ee ee ees Bre le ean tes ee esh(1) 
: uucico, uucpd: transfer files queued by uucp oruux. . 2. 2 ee ee eee uucico(8C) 
ftp: ARPANET file transferprogram. ........-0200 e000 5 ftp(1C) 
tftp: trivial file transfer program. . . . 2... 2 eee eee oe ee © tftp(1c 
ftpd: DARPA Internet File Transfer Protocol! ecver. is gh ve deren vei 8 Site Bie Cape er va te ftpd(8C) 
tftpd: DARPA Trivial File Transfer Protocol server. .....2... se bal eb: Jay tftpd(8C) 
tr: translate characters. 2... 1 0 ww we ew et ee ee tr(1) 
trpt: transliterate protocol trace. . . 2... 6 6 2 ee ee + + tepe(8C) 
trsp:. transliterate sequenced packet protocol trace. 2G ae So Scare trsp(8C) 
tcp: Internet Transmission Control Protocol, . . 2... 2.2 + ee eee tcp(4P) 
nwstat— report Ethernet Packet Transmission Firmware status. ...... at tee Wee Jan vas Zonet nwstat(8) 
uuencode, uudecode: encode/decode a binary file for transmission viamail. . .. 1... ..-5 002 ee eee uuencode(1C) 
trpfpe, fpecnt: trap and repair floating point faults. ......... =. . tpfpe3F) 
trapov: trap and repair floating point overflow. ........ .. trapov(3F) 
traper: traparithmeticerrors. . 2... 26 2 0 ee ee ee ew © traper(3F) 
export, login, read, readonly, set, shift, times, trap, umask, wait: command language. /exec, exit, ... . . sh(1) 
traper: trap arithmetic errors. . . . . oe ee eo oo oo «fraper3F) 
trapov: trap and repair floating point overflow. be car sce vain Six trapov(3F) 
V/O. topen, tclose, tread, twrite, trewin, tskipf,tstate: {77 tape ......-. - topen(3F) 
trek: trekkie game. 2 2 2 2 2 0 ee ee we tw we te tw trek(6) 
trek: trekkiegame. 2... 2.2 ee were vee . trek(6) 
topen, tclose, tread, twrite, trewin, tskipf, tstate:f77tapeVO. . 2... 2 2 2 ee ee topen(3F) 
sin, Cos, tan, asin, acos, atan, atan2: trigonometric functions and their inverses. . . . 1... 2. sin(3M) 
tftp: trivial file transfer program. .... 2-2 ee ee eee tftp(1C) 
tftpd: DARPA Trivial File Transfer Protocol server. 2... 6 2 2 ee ees tftpd(8C) 
tbl: format tables fornmroffor troff. 2 2 6 2 ww we ew et te tw we wt ww ws tbi(1) 
Lisp programs to be printed with nroff, vtroff, or troff. vip: Format 2... 6. 2 eee ee ee ww vip(1) 
troff, nroff: text formatting and ne a ee troff(1) 
deroff: remove nroff, troff, tbl and eqn constructs. 2... 2 1 6 ee te ee deroff(1) 
vwidth: make troff width tableforafont. . . 0... 0s ee ee eee vwidth(1) 
battlestar:a tropical adventure game. . 2. 2 2 2 2 ee ee te te es battlestar(6) 
faults. trpfpe, fpecnt: trap and repair floating point ........ trpfpe(3F) 
trpt: transliterate protocol trace. 2... 2. 1. 6 ew ee ee trpt(8C) 
trace. trsp: transliterate sequenced packet protocol ........ trsp(8C) 
true, false: provide truth values. 2. 2. 2. 6 2. 1 ee ee true(1) 
false, true: provide truth values. 2... 2 2 2 ee ee ee ee false(1) 
truncate: truncate a file to a specifiedlength, . 2... 1.2.22. truncate(2) 
truncate: truncate a file to aspecifiediength ........ truncate(2) 
false, true: provide truth values. 2. 2 0 1 2 2 we ee ee we ee we es false(1) 
true, false: provide truth values. 2. 2. 6 6 0 ew ee wet te we ew true(1) 
ts: TS-11 magtape interface. inlet le db? daa? eriet te oe eset o's ts(4) 
ts: TS-11 magtape interface. 2. 2... 2 2 wee ee wee ts(4) 
tset: terminal dependent initialization ......2.2.2.. tset(1) 
topen, tclose, tread, twrite, trewin, tskipf,tstate:f77tapel/O. .........426-. ; topen(3F) 
tsort: topological sort. . 2... 2. 2 2 ee ae, Wy wel tens tsort(1) 
topen, tclose, tread, twrite, trewin, tskipf, tstate:f77tapeVO. . 2... 22 2 2 ee wwe ee ewe topen(3F) 
tty: general terminal interface.  . 2... 1... ew eee tty(4) 
tty: get terminal name. gow. ei uel, Gia Sor Norns sake ereuale ces Wes Wn Sn c8 tty(1) 
ttynam, isatty: find name of a terminal port. 6s. Sa? Sepia? 2 wie 'e ttynam(3F) 
ttyname, isatty, ttyslot: find name of aterminal. ....... ttyname(3) 
getttyent, getttynam, setttyent, endttyent: get ttysfileentry, . 2... 6 2 0 ee we ew ww ew ews getttyent(3) 
ttys: terminal initialization data. .....4.2.4.. é trys(5) 
ttyname, isatty, ttysiot: find name ofaterminal. .........200086 ttyname(3) 
tunefs: tune up an existing file sysiem. . . 2... 2.2.0 2000-. tunefs(8) 
tunefs: tune up an existing file system. .......2... tunefs(8) 
topen, tclose, tread, twrite, trewin, tskipf, tstate:f77tapeVO. . ......%.- topen(3F) 
file: determine file type. 2. 2. 6 0 wwe eee eer cee we wer n ee file(1) 
stab: symbol table types. 2. 2. 2 2 2 0 ew te we we we ww . stab(5) 
types: primitive system data types. .....4... ae ee a ee ee ee types(S) 
types: abpent system data types. & aes ‘ . types(5) 
script: make typescript of terminal session. . .........206-. script(1) 
man: macrosto typesetmanual. .. 2... 26 ee ee eee eevee man(7) 
eqn, negn, checkeq: typeset mathematics. Oar er ee ee ee ee ae ie ee eqn(1) 
troff, nroff: text formatting and BO 65 ib iw ay Ne le ei ae fe ci he wees eee oes fon ae se troff(1) 
tzfile: time zone information. .......+.26-. * - tzfile(S) 
ctime, localtime, gmtime, asctime, timezone, tzset: convert date andtimeto ASCI].. ......4..24.-. ctime(3) 
ualarm: schedule signal after specifiedtime. ........ ualarm(3) 
getpw: getmame from uid. 2. 2 2 1 ee ee ee tt te eee getpw(3C) 
ul:dounderlining, 2... 1... 5. 2 ee eee wenn ul(1) 
umask: change or display file creationmask. ........ esh(1) 
umask: set file creation mode mask... ......24.2-. umask(2) 
login, read, readonly, set, shift, times, trap, umask, wait: command language. /exec, exit, export, sh(1) 
mount, umount: mount and dismount filesystems. .......4.. mount(8) 
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compress, 
ul: do 


expand, 


mktemp: make a 

gethostid, sethostid: get/set 

flush: flush output to a logical 

fseek, ftell: reposition a file on a logical 

getc, fgetc: get a character from a logical 

putc, fputc: write a character to a fortran logical 


learn: computer aided instruction about UNIX 


reboot: 

system: execute a 
uux: unix to 
uucp: unix to 
mitio: 

uux: 

uucp: 


rmdir: remove 
rm, rmdir: remove 


punlock: 


mmap, munmap: maps or 


getenv, setenv, 


uptime: show how long system has been 
tunefs: tune 
touch: 


sync: 
sync: 


update: periodically 


du: summarize disk 

quota: display disk 

what: show what versions of object modules were 
miscellaneous: miscellaneous 

login: login new 

talk: talk to another 

write: write to another 

seteuid, setruid, setgid, setegid, setrgid: set 
talkd: remote 

environ: 

whoami: print effective current 

su: substitute 

getuid, geteuid: get 

setreuid: set real and effective 

finger: 

fingerd: remote 

telnet: 

whois: DARPA Internet 

getuid, getgid: get 

ota: edit 

getusershell, setusershell, endusershell: get legal 


adduser: procedure for adding new 
binmail: send or receive mail among 
wall: write to all 

last: indicate last logins of 


getlog: get 
users: compact list of 


getrusage: get information about resource 
vtimes: get information about resource 
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umalias: remove aliases. ......- ° - ¢esh(1) 
uncompress, zcat: compress and oun data. ee ae ae compress(1) 
underlining. ...... . aie vee ee ce we MGL) 
unexpand: expand tabs to spaces, and vice ‘versa. Oe oe expand(1) 
ungetc: push character back into input stream. ..... . . ungetc(3S) 
unhash: discard command hash table. . .. . - ee ee a csh(1) 
unifdef: remove ifdef'ed lines. . . ..- > 5 8n eee Grd unifdef(1) 
uniq: report repeated lines in a file. ce ee ew ew ew oe ow « UNQ(I) 
unique filename, 2... 2 eee tee ee tet we we eee mktemp(3) 
unique identifier of currenthost. . . 2... 2. ee eee ee gethostid(2) 
MORI ig Ra Se See ae a LS et OW SR Se fiush(3F) 
UNit.. <6. 6 0a. Se oe we gi ete Sy 0 Se, hese . feeek(3F) 
unit 2... ww eee aia be feet es RO iah eo tan os cee ee ore getc(3F) 
unit, 2... 1 ew wee be’ Give foe estar shen wee Gade. feryeir dee fe putc(3F) 
units: conversion program. . 2... ee 6 ee ee ee es units(1) 

ei ie) se, We [es S! Stereo Vel fem a. ee pe le es we ee . learn(1) 
UNIX bootstrapping procedures. . . 2. 6 2 + 2 + +o « redoot(8) 
UNIX command. . 2... 5. ee ee we ee wes . system(3F) 
unix command execution, . . 6.02 5 0 6 ee eo oe ee WUX(IC) 
UDIXCOPy, 2. ee ee ee ee we ee ew ew ew we UUCMIC) 
UNIX magtape interface. 6 6. ee ee ee ee mtio(4) 
unix to unix command execution. . 2... 1 6 6 es ee ee uux(1C) 
unix toumix Copy. 2. 2. 2 2 ee ee ee ee ee ewes uucp(1C) 
unlimit: remove resource limitiations. ..... =... . . csh(l) 
(unlink) directories. . ... » Gd ior ace Die > Yael + fndir(1) 
(unlink) files or directories. . . 2. 2 2 0 se ee ee ee rm(1) 
unlink: remove a directory entry, A ee unlink(3F) 
unlink: remove directory entry, 2. 6 6 6 se ee ee eee unlink(2) 
unlock the current process. 2. 6 6 0 ee eee et ee punlock(2) 
ummaps pages. 2. 2 2 2 2 eee ee tt te te et mmap(2) 
unmount: remove a file sysiem. 2... 2. 2 6 ee ee eee unmount(2) 
unset: discard shell variables. 2. 2. 2. 2. 2. 2 ee ee eee csh(1) 
unsetenv: manipulate environmental variables. . ...... getenv(3) 
unsetenv: remove environment variables. . . . 2... 6 oe csh(1) 
MDS 6 ae hiss ag a Se ee a Se Se eS ee uptime(1) 
up an existing filesystem. . . 2. - 2 2 see eevee tunefs(8) 
update date last modified ofafile. . 2... 2... ee eee touch(1) 
update: periodically update the superblock. ........ update(8) 
update super-block. 2. 2. 6 2 1 ew ee ee we ee ee sync(2) 
update the superblock. ..... ore eh ee eS Bee era sync(8) 
update the superblock, 2... 6 6 ee ee ee ee oe update(8) 
uptime: show how long systemhas beenup. ........ uptime(1) 
usage. . 2. 2 ee a 6, Wel hfe 8 1a, kale es ew Se ie du(i) 
usageandlimits. ..... Siciah arte ce? oe" er Me ayes a> a) ews quota(1) 
usedtoconstructafile. . . 6.6. 6 ee ee ee we eee what(1) 
useful information pages et Jos leiy ls. ‘eta iedual 10t ie) <@ fore) arlene intro(7) 
UBER 5.6 ee ele ae SS 0 6 a ESO eS csh(1) 
user. a BS Aim gt igh vate las SHS) Gel. ow a 485 per) OP ee iS a talk(1) 
USOT S066. oo ep ce, eS fern 9? Gor IS: Mae 9 oa ee 28S) oe write(1) 
user and group ID. setuid, ..... glee te! Se: dee setuid(3) 
user communication server. Sb che ele Tee See toe ace Lee en ers talkd(8C) 
userenvironment. 2... 2 60 ee ee ewe ww wwe environ(7) 
userid. . 2... 2 wee olan ie Nase wai wy ey to uiyO a2 Te vce ee 88 whoami(1) 
userid temporarily, . 2... 6 ee ee ee ee ee ewe su(1) 
useridentity. . 2... 2 2. eee ee 6 eS Bin Severe, ws getuid(2) 
userID’s. ...... Bia) ere ah a Ota t Bie ae es setreuid(2) 
user information lookup program. ae Ce ae oe aa are . finger(1) 
user information server. . 2... 2 ee ee eee ws fingerd(8C) 
user interface to the TELNET protocol .........-. telnet(1C) 
user mame directory service. . 2. 2. 2 eee ween whois(1) 
user or group IDofthe caller. ............. . getuid(3F) 
user quotas. 2 6 6 6 ee ee ee we ee et ww ww we CMQUOtA(S) 
usershells. 2... 2. eee eee ee ew ee ew ww we © getusershell(3) 


USERFILE: UUCP pathname permissions file. ..... . 


UBELE:. © 6 ves 0) cee. Le We: 26 Gy Hee Ses OF ee Se ere eye adduser(8) 
USETS, 8. ee we ew ws a ce a ae eee ee binmail(1) 
MISOTS) 66 eae Gs, Smelt =e ces Sa iw ct or Bes Os YS wall(1) 
users andteletypes. . . 2... Si evel ee ie tee 9? ee ek last(1) 
users: compact list of users who are on the system. ..... users(1) 
usersloginname. . 2... 26 6 ee ee ew eae . . getlog(3F) 
users who are on the system. 6 ee ee ee ee ee users(1) 
usleep: suspend execution forinterval .......... usleep(3) 
utilization, . 2... 1562+ eee ee ae ee ee getrusage(2) 
utilization. . Se Wns ee Swe he, Be, Be vtimes(3C) 
utime: set filetimes. 6 2 0 6 0 ee ee we we th ee ww utime(3C) 
ulimes: set file times. 2. 2. 6. 0 1 we ee we eo ewes utimes(2) 
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uux. 


mail: handle remote mail received via 
L-devices: 
uuxqat: 

Laliases: 

uuname: list names of 

uulog: display 

uucico, uucpd: transfer files queued by 
USERFILE: 
L-dialcodes: 

uug: examine or manipulate the 
L.cmds: 

Lsys: 

uupoll: poll a remote 

uuclean: 

uusnap: show snapshot of the 


uucico, 
transmission via mail. uuencode, 
uuencode: format of an encoded 


transmission via mail. 


uucico, uucpd: transfer files queued by uucp or 


vacation: return ‘‘I am on 


abs: integer absolute 

hypot, cabs: Euclidean distance, complex absolute 
functions. fabs, floor, ceil, rint: absolute 
readlink: read 

getenv: get 

getitimer, setitimer: get/set 

set: change 

false, true: provide truth 

dfimin, dfimax, dffrac, inmax: return extreme 
rand, drand, irand: return random 

true, false: provide truth 

htonl, htons, ntohi, ntohs: convert 


set: change value of shell 

varargs: 

setenv: set 

@: arithmetic on shell 

unset: discard shell 

unsetenv: remove environment 

getenv, setenv, unsetenv: manipulate environmental 
getenv: get value of environment 

signals invalid floating-point operations on a 
assert: program 

assert: program 

lint: a C program 

expand, unexpand: expand tabs to spaces, and vice 
vfont: font formats for the Benson-Varian or 
hangman: Computer 

file. what: show what 

Versatec. 

efficient way. 


vgrindefs: 

terminal. 

on ex. 

encode/decode a binary file for transmission 
rmail: handle remote mail received 

expand, unexpand: expand tabs to spaces, and 
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utmp, wimp: login records. . 2. 2 ee es ee eee es utmp(5) 
uucico, uucpd: transfer files queued by uucp OF 2. ee ee « UUcico(8C) 
uuclean: uucp spool directory eee ee ee ee uuciean(8C) 
LT Ce) rmail(1) 
UUCP device description file. ab ieeitat te eviey @ctaiserne® eer ta L-devices(5) 
UUCP execution file interpreter. . . 2. 2 2 es ee eee uuxqt(8C) 
UUCP hostname aliasfile. 2... 2.2 2 eee ee eee L.aliases(5) 
WUCP OBB. as Se ee Oe WW He WH ee OO uuname(1C) 
UUCP log filets |<: s6: 6 Gis a6 9S ROH SSH uulog(1C) 
uucp or uux. 5S: 6 Lint WL erie, ati Oi wer ieie Ger eles wucico(8C) 
UUCP pathname permissions ley eGo as eo Teese ee A USERFILE(5) 
UUCP phone number index file. 2... 2 6 ee ee ee ee L-dialcodes(5) 
wucp queue. 2... 2 ee ee we we ee we we wes - unq(1C) 
UUCP remote command permissions file. . .... +++ - L.cmds(5) 
UUCP remote host description fille. .....- bial whG ca oe L.sys(5) 
UUCP Bite, 2.6 2 wee ee et ee ew we ww ww © ~«poll(8C) 
uucp spool directory clean-up. ...... - + +6 » Uuclean(8C) 
UUCP system. 2 0 2 2 1 ee ee ee ww ew ww ww © ~«UUSap(8C) 
uucp: unix toumix Copy. . 2... 2 + ee ee oe 6 © UUcp(IC) 
uucpd: transfer files queued by uucporuux. ........ wucico(8C) 
uudecode: encode/decode a binary filefor . . 2... s+ 6s uuencode(1C) 
wuencode file. 2... 2. 2 eee eee ee by eira eh ee ee wuencode(5) 
uuencode: format of an encoded wuencode file. ma er ee ee wuencode(5) 
uuencode, uudecode: encode/decode a binary filefor ..... wuencode(1C) 
wulog: display UUCP log files. .. . 2... e+e ee ee uulog(1C) 
uuname: list names of UUCP hosts. .. 2... + see ee uuname(1C) 
uupoll: poll a remote UUCP site. . . 2... 2. 2 eee ee uupoll(8C) 
uugq: examine or manipulate the uucp queue. ........ wuq(1C) 
uusend: send a file toa remote host. .. 2... 2.2.2 2 ee uusend(1C) 
uusnap: show snapshot of the UUCP system. ........ uusnap(8C) 
WKS ors ads es eS: eee Pas Des Aeoniah-steh, ot lee veka ence 8 uucico(8C) 
uux: unix to unix command execution. ........26-. uux(1C) 
uuxqt: UUCP execution file interpreter. .. 2... -.-.-- uuxqt(8C) 
vacation’’ message. 2. 2 2 2 2 2 ee ee ee tw ee vacation(1) 
vacation: return ‘‘I am on vacation’’ message. ....... vacation(1) 
valloc: aligned memory allocator. ... 2... 2 ee ee valioc(3) 
valloc: aligned memory allocator. . 2... 2.522. eee valloc(3C) 
Wales: ca :62 lel 6 6, ey cee Ce: Hb. eS ves BM eh es SS SR abs(3) 
WENIG =i abit ae a oe gt Ba ee at Se Ee oe hypot(3M) 
value, floor, ceiling, and round-to-nearest . 2... 1.2.6. floor(3M) 
value ofasymboliclink 2... 1. 21 eee ew ew wn readlink(2) 
value of environment variables. . . 2... 2.2. 2 ee eee getenv(3F) 
value of intervaltimer. .. 1... 2.2.2.2. 2 ew eee getitimer(2) 
value of shell variable, 6. 1 ww we et te ee csh(1) 
values. 2... 2 we ew we ee ee Silence Nenad O95 S Sete- Tet, es false(1) 
values. fimin, fimax, ffrac, . 2... 1 2 eee ee we wwe fimin(3F) 
VANCE <6 6 Gre ow a re ee a es ee es eae eae rand(3F) 
Valiese: 55.5 eb Ae Bee eas ws bs cee sO) os eS true(1) 
values between host and network byteorder. . 2... 2 we byteorder(3N) 
varargs: variable argument list. 2... 2.1. 1 we ee varargs(3) 
VATIADICS 2-4 Jeo ee? OR Sc Sa Rw, oe eee csh(1) 
variable argument list. 2... 2. 11 20 ee eee eee varargs(3) 
variable inenvironment. . 2... 2 2 2 ee ee ee we esh(1) 
VATIADIOS. $806, Gece 6m Swe We ie a oe ee csh(1) 
variables. 2... 2 eee a ee ee eee Si: dda eile a. es ale esh(1) 
variables. . 2... 2... ‘ high Os cao GC ak Hae Se cesh(1) 
WEPADICS... 4: 3. 6 Se 88S sw ah wl nee eso getenv(3) 
WOPMNES. dso ese rae Bie wR Se ge eee getenv(3F) 
VAX (temporary). infnan: . .. 2... 2. ee ee eee infnan(3M) 
WETACANON. 6. 6-5 ee i Se we ee Se assert(3) 
WerifiCAHlON... <6 he. 055 Pe), WSR Bee ck eee . « assert(3X) 
verifier. Ss tes ey cor RORY ems Se. m . + + « Lint(1) 
VOTER soe: 5 oa ees BEET eR G8 erie? aS , expand(1) 
Versatec. .. 2... a ee ee ae ee ee ee vfont(5) 
version of the game hangman. he aa iaeslas ae sgh a ecg, hangman(6) 
versions of object modules were used to constructa ..... what(1) 
vfont: font formats forthe Benson-Varianor ........ vfont(5) 
vfork: spawn new process ina virtualmemory ....... vfork(2) 
vgrind: grind nice listings of programs. ........2.. vgrind(1) 
vgrindefs: vgrind’s language definition database. ... . . . vgrindefs(5) 
vgrind’s language definition database. .........- vgrindefs(5) 
vhangup: virtually “‘hangup’’ the currentcontrol. . .. . . vhangup(2) 
vi: screen oriented (visual) display editorbased . ...... vi(1) 
via mail. uuencode, uidecode: .......08e08088 uuencode(1C) 
viauucp. .....+.-. Re aR Te GA ek ee Sica To a rmail(1) 
WCE VETER, 653. fe te ae a? Gta es ele Ree greene expand(1) 
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more, page: file perusal filter for crt 


WIGWENGS « do-'55 205, 4-6. aah ee at RR eC ew ee Ae more(1) 
robots: fight off villainous robots. . 2... 1. ee ee ee ees - fodots(6) 
vipw: edit the password file. 2... 62 ee ee . . Vipw(8) 
vfork: spawn new process ina virtual memory efficient way. . 2... 6. 20 we ee ee vfork(2) 
vmstat: report virtual statistics. ats «ee - vVimstat(1) 
vhangup: vittually ‘‘hangup”’ the current control terminal. gy ae ee vhangup(2) 
vi: screen oriented (visual) display editorbasedonex. . 2... 6 se ee eee vi(1) 
consumption. viimit: control maximum system resource... 1. 2-6 +s vlimit(3C) 
vtroff, or troff. vip: Format Lisp programs to be printed with nroff, ep ace es vip(1) 
3270: full-screen remote login to IBM VM/CMS. re a a ee ee ae ae eee . + 6 t23270(1) 
ad: ‘VME SCSI disk adaptor interface. is tle 6s se, ve ee a He Ze 8d(4) 
sm: VME SMD disk interface. .......0-22-24-4-. sim(4) 
mem, kmem, vmem: mainmemory. ... 2... 2-22 eee eee - . mem(4) 
vmstat: report virtual memory statistics. . 2. 2... 2. 6s vmstat(1) 
fs, inode: format of file systiem volume. . . 2... 2 ee ee ee eee ese veces fs(5) 
vtimes: get information about resource utilization. ee oe er vtimes(3C) 
vip: Format Lisp programs to be printed with nroff, vtroff,ortroff. ..... aS ay Sacirlele (S-giasgn 40h fos, ore, Veh vip(1) 
vwidth: make troff width table for a font. ..... ‘ - vwidth(1) 
“w: who is on and what they aredoing. ..... +--+ s+. w(1) 
wait: swait completion of process. . 2. 2 6 6 6 2 ee eee wait(1) 
read, readonly, set, shift, times, trap, umask, wait: command language. /exec, exit, export, login, ..... sh(1) 
Wait: waitforaprocesstoterminate. . . 2. 2.6 ee ee ee we wait(3F) 
wait: wait for background processestocomplete. ........ ‘esh(1) 
sigpause: atomically release blocked signals and waitforinterrupt. ....... ee ee ee sigpause(2) 
wait, wait3: wait for processtoterminate. . 2... 2 2 ee ee eee wait(2) 
wait: wait fora processtoterminate. ........0068- wait(3F) 
wait: wait for background processes tocomplete. ...... csh(1) 
wait, wait3: wait for process toterminate. .......2.. wait(2) 
wait, wait3: wait for processtoterminate. .......2..20. wait(2) 
atq: print the queue of jobs waitingtoberun, 2... 1 1 1 ee ee ete te atq(1) 
wall: write to all users. Beet el Has Nan Ge ca) deh ees Ee ee wall(1) 
we: wordcoumt. 2... 2. ee eee te ee ew ew we(1) 
what: show what versions of object modules were used toconstructafile. ........0.+02000-4 what(1) 
whatis: describe whatacommandis. . .. 2... 2 6 ee ee we we ewe whatis(1) 
crash: what happens when the system crashes. eof aa a te a crash(8V) 
used to construct a file. what: show what versions of object modules were ...... what(1) 
w: who ison and whattheyaredoing, .......-.+6-.-52020e0e06-, wil) 
construct a file. what: show what versions of object modules were used to soe ee © « © 6What(l) 
whatis: describe whata commandis. ......... . . wWhatis(1) 
crash: what happens when the systemcrashes. . 2... 2... 2 2 eee eens crash(8V) 
leave: remind you when you havetoleave. . 2... 1.6 6 1 ee ee so © leave(l) 
program. whereis: locate source, binary, andor manualfor ... . . . whereis(1) 
paths (c s h only). which: locate a program file including aliasesand ...... which(1) 
exec, exit, export, login,’ sh, for, case, if, while, :, .,break,continue,cd,eval, ........6+2-. sh(1) 
while: repeat commands conditionally, ........2-. esh(1) 
break: exit while/foreachloop. .. 2... 2.2 21 ee ee wees cesh(1) 
users: compact list of users whoareonthe system; . . 2... 22 2 ee ee eee users(1) 
from: whois my mailfrom?,. .... 2.6.2. .06 5228s from(1) 
w: who is on and what they aredoing. ..........206% wil) 
who: whois onthe system. ... 2... 2. eee ee eevee who(1) 
biff: be notified if mail arrives and whoitisfrom. ........s.ee. bs eines: are Sew biff(1) 
who: who is on the system. 2... 2 2 0 0 eee ee eee who(1) 
whoami: print effective currentuserid. 2... ....2.2.. whoami(1) 
whois: DARPA Internet user name directory service. . whois(1) 
rwho: who’s logged in on local machines. 3... . 2... 220 twho(1C) 
fold: fold long lines for finite width output device. .........222.- PROS a 2g ts fold(1) 
vwidth: make troff widthtableforafont ...... Se Se BE ee gt at oP vwidth(1) 
window: window environment. aa oe Boece tb ce ee ee en window(1) 
window: window environment. .........0s2ee8-. window(1) 
fastboot, fasthalt: reboot/halt the system without checking the disks. . 2... 2... ....2..000¢ 6 fastboot(8) 
sail: multi-user wooden shipsandironmen. .......2. 2.0006 sail(6) 
we: wordcount < 6.0 6 6 6 8 6% ee Se we ee ef we(1) 
getc, getchar, fgetc, getw: get characteror wordfromstreaam. . . 2... 2. 2 ee eee ee eee getc(3S) 
putc, putchar, fputc, putw: put characteror wordonastream. . . 2... 2.2. eee see . . putc(3S) 
diction, explain: print wordy sentences; thesaurusfordiction. ......2.2.2.. diction(1) 
cd: change working directory, 2... 2 2 ee ewww ee ewe cd(1) 
chdir: change current working directory, . 2... 2 2 2 ee se ee eevee chdir(2) 
getcwd: get pathname of current working directory. . 2... 2 2 6 eee eee eww getcwd(3F) 
pwd: working directoryname. 2... 2-0 2 2 ee ee eee pwd(1) 
getwd: get current working directory pathname. .. 2... 1... ee eee getwd(3) 
worm: Play the growing wormgame. ....... eo veh Bane ves We Wa ee tee ese worm(6) 
worm: Play the growing worm game. . . . 2... 2.2... worm(6) 
worms: animate worms on a display terminal. ....... worms(6) 
worms: animate worms ona display terminal. ...........2.02. worms(6) 
putc, fputc: write a characterto a fortranlogicalunit .....2.2.2.2. putc(3F) 
write, writev: writeoutput 2 2. 6 6 ee ee te et tw ee es write(2) 
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wall: writetoallusers. ........ it alee ene eel eS wall(1) 

write: writetoanotheruser, 2... 0... see eee eee es write(1) 

write: write to another user. aS, 6h ee! eee) we eee: foe. Ww ite(1) 

write, writev: write output. ....... oe ae a write(2) 

write, writev: write output. ....... ah tee eee ts + «6 « Write(2) 

Open: open a file for reading or writing, or createanewfile. . 2... 2... ee ee eee open(2) 
style: analyze writing style ofadocument. ..... eee a ae ee style(1) 
utmp, wimp: loginrecords. 2... 1. 1 wee eee ee ew utmp(5) 
wump: the game of hunt-the-wumpus. .......- +6. wump(6) 

ns_addr, ns ntoa: Xerox NS(tm) address conversion routines. . ......-. ns(3N) 
“xsend, xget, earoll": secret mail. Sil, se rak Bee sey ie rae ae. ein ware xsend(1) 
XNSrouted: NS Routing Information Protocol daemon. . . . XNSrouted(8C) 

bit: and, or, xor, not, rehift, Ishift bitwise functions. .......-+..- bitGF) 
"“xsend, xget, enroll": secretmail, . 2... 0. ee eee xsend(1) 

shared strings. xstr: extract strings from C programstoimplement ..... xstr(1) 
j0, jl, jn, yO, yl, yn: bessel functions. .... 2.2224... OGM) 


jO, jl, jn, yO, yl, yn: bessel functions. ......... 
yacc: yet anothercompiler-compiler. ... . 

yes: print text repeatedly, .......4- 

j0, jl, jn, yO, yl, yn: bessel functions, ......2.. ide 


compress, uncompress, zcat: compress and expand data. . . 2... .. 2s + «+ « Compress(!) 
tzfile: time zoneinformation, ..... eho". toy ot Wi teks, <a cero tzfile(S) 
zork: the game of dungeon. . 2... 2 2 2 we ee ew ew zork(6) 
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1. Commands and Application Programs 


intro ce ew wee we we we ee ww ww oh ew ww ww oe ee ~~ introduction to commands 
BOD: Bw ey ay a eS, Rn We A eee ewe, SOR io) wh ie Se ee S Bebubper 
addbib cet wt ee we we ww we thw ww wh ww ee ~=©6CrOate Or extend bibliographic database 
apply . 2.6 eww ee ew we ew ww we oe we oe * ~©~©6Oapply acommand to a set of arguments 
apropos... ww we et tw wt wt ew ew ww et ee heh heh ~©6OCate Commands by keyword lookup 
Ww we we te tw th te wt we ww ww tt ww ee ~)©6 achive and library maintainer 
Bow we ww ww ew ww we ew we ew ew ew st © © © )©MC68000/MC68010/MC68020 assembler 
Aw ww ew ww we ewe we we we we we ww wwe ~=6CXOCUtE COMMands at a later time 
atq ce ee ew tw ww tw ww ww ow oh ee © ~~ €@print the queue of jobs waiting to be run 
atrm wee wee wwe ee ee wee ew tw ew ww oh ww ow ee )~©6FeMOVE jobs spooled by at 
awk cee te we ww te ee ww ww we ww we ~~ «pattern scanning and processing language 
SONA 6 55S Gas, Gas Sa Gea os Se a Ss a a Se oe eS strip filename affixes 
be cee we we ew ww we tw ww ww ww ww © ~~ Mfbitrary-precision arithmetic language 
biff 2. 21 1 ww ww ww ee ww ww ww ww te ~©«<DOC NOTified if mail arrives and who it is from 
binmail ce tw ee wh we te we ww wh ww ww ww ew fe ~)=«SONM OF receive mail among users 
Cal ger ws Se ae Bo See ee ee ee a a a Se ee es Se OPE Calendar 
Calendar: sk 3s 6. ee we cee ew eo ee ew eo ow ww ew ow we of ~©6eMminder service 
cat oe me ew mr eee eee meee ewe eo eee eee oo oe oe «~=6(CMtenate and print 
cb ee er Van ae de Ag: Me ce tw eh ee we te ww ww ew we oe ee eh e)©6C program beautifier 
cc i GR Iai Pile Ge teva > ho tee at sees eo ce Bo. Gee ES ee Re we le ee s “A Compiler 
cd cee eee ee ewe wee we te we te wt et te 8 ww oe fl fl )6Change working directory 
ib, Bey ee 2 6 6 © © © © ~©6Check nroff/troff files 
COIR a ee eee we, SO et ee ae ar o ee ee © © oe © © ~)©6UChange group 
CMO? oes 6 eins Se ee eG Le a a Rw A Be ORS Hw AOS Se 4S ow RANGE Mode 
clear ..... a ee ee ae ee ee a ee eee + «+ +. Clear terminal screen 
. « compare two files 
— oe eo ew ee ee © ~) édffilter reverse line feeds 
COLE 9 ss ise ee ae OS aS SS oe ee © © © filter nroff output for CRT previewing 
colrm cee ee ww ww ww wwe ww ww ow ww ww oe he he)©6UremOve COlumns from a file 
COMM: 405: 8. 4 he eas oe ee eo ee ~~ «Select or reject lines common to two sorted files 
«+ + « « Compress and expand data 
CD? al ee, Ua ae Ke as Oe Se ee xe So BoM Gene Se Bee: ee a eee eh he? CODY 
Cfypt 6 we wee we ew we we errr wre eee erence eee eee eo o 6 «6Oncode/decode 
CSN hice pente Bee Gee A Be. eM . «+» e .  aShell (command interpreter) with C-like syntax 
ctags Bisah erg Sage. & Ge De a, eee “Ee: al Ble as MS es he sia Nabe Sele ene create a tags file 
(cb: || a a ea ee eee a cee ew ew ew we wo ow wo we ~~ «print and set the date 

i ew ele ee ee oe ws @. “Bebugger 
dC 2. ea ake. 6 eo We Oe ee NAN ees Wo Woe Ym Se es ei ee a Ae Se aha a. | MOS Calculator 
Ge ek ee sees i we ee ee es Be eS ea ee ee SCOniVert and Copy a file 
GOGO . 6 ese ale oe eS eae or oe ee a remove nroff, troff, tbl and eqn constructs 
ah i Sia Ase sas San oe “Nie Car ago an ge ee: - SE TC 
diction cee ee ew we we ww we ww ew oe ee ~~ «@print wordy sentences; thesaurus for diction 
Giff 2... 6 2 ewe we ew ww ww we ww we ~~ differential file and directory comparator 
Giff 6 ww ww ww we ee ew ww ww ww ww we ww ee ~«=©6 Sway differential file comparison 
domainname ......2.2-202ee+ee coe - set or display name of current domain system 
GU ein ee Ge ete ce a eee Be ew ee ews ee eee - SeInManize disk usase 
echo 8 ee eH 8 eee oe 8 e 6 8 6 66 6 eee oe 6 oe oe ee se) «6«@ChO arguments 
ee text editor . 
OIE toa oe a a Tae Sw Say ce ee ew te we ww we ow eh ee eh e)6UcEXtended Fortran Language 
eqn Se ee we we ww eww ww we ww we woe we wo wee oo ew ow oo «typeset mathematics 
error ce ee eee ww ww ew ww we ee ~~ OaMalyze and disperse compiler error messages 
OX: e628 8 ae Ty" See aA a Sa pat anaes ae fas ste Se Na St aR Vd 2 -Sa an  , CREE ECHOE 
expand . ww we ew tw Beth sacle By eR Ce eh oie ®t ae ae expand tabs to spaces, and vice versa 
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expr eee ew wr ee we ww we we we ew we wo we we we ef )~|6CVAlUate arguments as an expression 
f77 Ag. cette tate albeit et al ete Bg oo. hry . « . + Green Hills Fortran 77 compiler 
Talse 2 °o 2 Se eS Ge BE EK OO OR Se ON eS PROVE Guth values 
Gl ho a EE Oe a OW, EE a OM aS @ ae eS ~Cetermine file type 
TG 5 ee ik Soe GS Fas Bs a Shi BS a HOE ew OO ee ws. Hind Giles 
finger 2. ww ee tee ee we ee we ew we we we ew we © ~~ USEF information lookup program 
FMt nie 6 Se be RS ee 8 a Sw ws ce we we @ s «SiMple text formatter 
fold cee ee te we ww we ww we ow oe oe © ~© fold long lines for finite width output device 
OE 5 ee See le wer ante ey ee ee Soe eS RO Be, Se a we, Re ee eee: Se! “PEIN Boriran file 
from wg ww tt tt tt tt tw tw tw wt ww ww we ee oe @ « ~)©6Whois my mail from? 
fsplit .. 2... +66 26 6 © «© © © © © © ~~~ Splita multi-routine Fortran file into individual files 
ftp cee ee we tt we ww ww we ww oo ow ee @ «© ~©6ARPANET file transfer program 
goore ww ttt et et ee tw we th ww we we we ww ~=«6get core images of running processes 
BProfe ww ew ee et wt we we we ww we ww oe © ~=©6<iSplay Call graph profile data 
graph a ee te RON ae i eo We bee eS yee we eee Ce 6 Cee ae ey 8, We Oran 
grep Ce} 6 8 8 8 6 lee ee ee 8 ee ee ee we oe we sl «)©«=6SOeTCh @ file for a pattern 
SrOUPS 6 ww ww wt we wt we te ww ww wo ww wo ee © ~=©6 SHOW group memberships 
head RU BR ee Rw a we ee ear ee: Bae a a |e eee give first few lines 
ROSGG oe GN a oe ee Se a oe 6 ee © ~~ «6Setor print identifier of current host system 
hosmame ........6-. oe ee ew ee ee ee ~~ «SOtOr print name of current host system 
indent 2. 1. 1 1 6 www ww ew ww we ow oe ww wt ee se ~=©andent and format C program source 
install ria? OES Ee oa ie! oa Be, al a, Wee WETS ioe ais Be! ow S-s e,. -nstall binaries 
WOSTAE. 6. oe. Gantt Bese Se a a ee oe at a we ee OS ee ww, @ POLO Statistics 
FOUN 8 eet Gs hose eo Bae oe ee we ee ww we ew eh oe ee /~©@<elational database operator 
kill cee ee ew ee tw te wt wh ww we ww ~~ «terminate a process with extreme prejudice 
last 6 ww we ew we ew we ew we th ww ow we © ~~ indicate last logins of users and teletypes 
lastcomm ede era we eae Bay pra Seh oe ova ie . Show last commands executed in reverse order 
TOs. oe eS eS Was Oe ee eRe ea Bees wh eae, AIneditOT 
leam ww ww tw ew ee wee we ww ww we oe  ~~©6COMputer aided instruction about UNIX 
TCAVG: gs hos ee es ee ee 6 fee ee es remind you when you have to leave 
lex ce ee ew wee we we we ww ww we ww we ~~ 6enerator Of lexical analysis programs 
lint © ec Se SS LR EUR, eo Re Gs SO eS ei See SS eee eA COE program verifier 
lisp BF cab Adee Gly hus tetas Das Yan cae We ce ee See Ee see ee oe ee ee © © ~~ @*LiSp interpreter 
liszt 6 ww ew ee ew et ww we ww ww te wh we wt we © ~©6COMpile a Franz Lisp program 
TS 2p SENG Be ee SB Se ee 1 eS Oe aS oe ee ee © © ©~=6©Make links 
MOCK: Se ken, BS ee Tie PRS eee WS RO hoa ek BEG wl ee Bl ees es eServe aiterminal 
WORGCR pgs Pe! ee ewe Sie ee Gs oe 6 © © © © © © © ~~©6make entries in the system log 
WORIM: << ewe: ew eR Se ee Re gt Gere, Se es ea Wh ee es ee ae “SIENON 
look WW eee ie! eS le eS eee ew Be See es oe Hand dines in a'sorted list 
lookbib ...... .. ~~ build inverted index for a bibliography, find references in a bibliography 
Jorder ww ww we ew te et ew tw we wh we we ~~ find ordering relation for an object library 
Ipq 2 ww ww we te we we ww hw wt ww tt ww te oe ~©=6SpOO! Queue Examination program 
TR og ool ee a esi ces a Se ae TR a ge AGE ee es ea eee ce ae 7 ON ne pant 
Iprm ce ew ww we ww ow ww ow we oe ee ~©6remove jobs from the line printer spooling queue 
Iptest 2. 2 we ww ew ew we we ew we ww we ew ww we  ~©6generate lineprinter ripple pattern 
Is ce ew we ee ee we wr we we ww we ww wo ww ww et ow © | «List contents of directory 
ixref cee we we owe we we we wo ww hw oe wo oe ee © «Lisp cross reference program 
WN ist bbe We es ae lew eee AS ee: Se ee ew ee Se ew CTO processor 
mail she PO GS ee a ae es es, HO Sas Se a 8a a send and receive mail 
make se ee we ww wh we we we we ww we ww ow ww ow ew oe ~)©6maintain program groups 
MAN 6 ke ee a ee ee ee - - find manual information by keywords; print out the manual 
MESB ww wt ew we wt et te ww he tt ww hw ww ww of ~©6permit or deny messages 
MEG 6 6. Se OS SE eS. 6 a ASB ES eee we . Sake edirectory 
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NAME 
intro — introduction to commands 
DESCRIPTION 
This section describes publicly accessible commands in alphabetic order. Certain distinctions of purpose 
are made in the headings: 
(1) Commands of general utility. 
(1C) | Commands for communication with other systems. 
(1G) | Commands used primarily for graphics and computer-aided design. 
N.B.: Commands related to system maintenance used to appear in section 1 manual pages and were dis- 
tinguished by (1M) at the top of the page. These manual pages now appear in section 8. 


SEE ALSO 
Section (6) for computer games. 


How to get started, in the Introduction. 


DIAGNOSTICS 
Upon termination each command returns two bytes of status, one supplied by the system giving the cause 
for termination, and (in the case of ‘normal’ termination) one supplied by the program. See wait and 
exit(2). The first byte is 0 for normal termination. The second is customarily 0 for successful execution, 
nonzero to indicate troubles such as erroneous parameters, bad or inaccessible data, or other inability to 
cope with the task at hand. It is called variously "exit code," "exit status," or "return code," and is 
described only where special conventions are involved. 
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NAME © 
adb — debugger 
SYNOPSIS 
adb [ options } [ objfil [ corfil ]] 
DESCRIPTION 
Adb is a general purpose debugging program. It may be used to examine files and to provide a controlled 
environment for the execution of UNIX programs. 
Objfil is normally an executable program file, preferably containing a symbol table; if not then the symbolic 
features of adb cannot be used although the file can still be examined. The default for objfil is a.out. Corfil 
is assumed to be a core image file produced after executing objfil; the default for corfil is core. 
Requests to adb are read from the standard input and responses are to the standard output. 
Adb ignores QUIT; INTERRUPT causes return to the next adb command. 
In general requests to adb are of the form 
[address] [, count ] [command] [;] 


If address is present then dot is set to address. Initially dot is set to 0. For most commands count specifies 
how many times the command will be executed. The default count is 1. Address and count are expres- 
sions, 


The interpretation of an address depends on the context it is used in. If a subprocess is being debugged 
then addresses are interpreted in the usual way in the address space of the subprocess. If the operating sys- 
tem is being debugged either post-mortem or using the special file /dev/mem to interactive examine and/or 
modify memory the maps are set to map the kernel virtual addresses which start at 0x80000000 (on the 
VAX). 
OPTIONS 
~-Idir Specifies a directory in which to be read with $< or $<< (see below) will be sought. The default is 
/usr/lib/adb. 


~-k Forces adb to perform UNIX kernel memory mapping. This option should be used when core is a 
UNIX crash dump or /dev/mem. 


-w Creates and open both objfiland corfil, if necessary, so that files can be read, written, and 
modified. 


EXPRESSIONS 
‘. The value of dot. 


+ The value of dot incremented by the current increment. 
~ The value of dot decremented by the current increment. 
7 The last address typed. 


integer A number. The prefixes Oo and 0O (‘‘zero oh’’) force interpretation in octal radix; the prefixes Ot 
and OT force interpretation in decimal radix; the prefixes Ox and OX force interpretation in hexade- 
cimal radix. Thus 0020 = 0t16 = 0x10 = sixteen. If no prefix appears, then the default radix is 
used; see the $d command. The default radix is initially hexadecimal. The hexadecimal digits are 
0123456789abcdefABCDEF with the obvious values. Note that a hexadecimal number whose 
most significant digit would otherwise be an alphabetic character must have a Ox (or 0X) prefix (or 
a leading zero if the default radix is hexadecimal). 


integer fraction 
A 32 bit floating point number. 


‘cccc° The ASCII value of up to 4 characters. \ may be used to escape a *. 
< name The value of name, which is either a variable name or a register name. Adb maintains a number 
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of variables (see VARIABLES) named by single letters or digits. If name is a register name then 
the value of the register is obtained from the system header in corfil. The register names are those 
printed by the $r command. 


symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The backslash character \ may be used to escape other characters. The value of the symbol 
is taken from the symbol table in objfil. An initial _ will be prepended to symbol if needed. 


_ symbol 
’ In C, the ‘true name’ of an external symbol begins with _. It may be necessary to utter this name 
to distinguish it from internal or hidden variables of a program. 


routine name 
The address of the variable name in the specified C routine. Both routine and name are symbols. 
If name is omitted the value is the address of the most recently activated C stack frame 
corresponding to routine. (This form is currently broken on the VAX; local variables can be 
examined only with dbx(1).) 


(exp) The value of the expression exp. 

Monadic operators 

*exp _ The contents of the location addressed by exp in corfil. 
@exp The contents of the location addressed by exp in objfil. 
—exp _ Integer negation. 

“exp ___ Bitwise complement. 

#exp _ Logical negation. 

Dyadic operators are left associative and are less binding than monadic operators. 
el+e2 Integer addition. 

el-—e2 Integer subtraction. 

el*e2 Integer multiplication. 

el%e2 Integer division. 

el &e2 Bitwise conjunction. 

el|e2 _Bitwise disjunction. 

el#e2 EJ rounded up to the next multiple of e2. 


COMMANDS 
Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. (The commands ‘?’ and ‘/’ may be followed by ‘*’; see ADDRESSES for further details.) 


of Locations starting at address in objfil are printed according to the format 
f . dot is incremented by the sum of the increments for each format letter (q.v.). 


if Locations starting at address in corfil are printed according to the format f and dot is incremented 
as for ‘?’. 

=f The value of address itself is printed in the styles indicated by the format f. (For i format ‘?’ is 
printed for the parts of the instruction that reference subsequent words.) 


A format consists of one or more characters that specify a style of printing. Each format character may be 
preceded by a decimal integer that is a repeat count for the format character. While stepping through a for- 
mat dot is incremented by the amount given for each format letter. If no format is given then the last for- 
mat is used. The format letters available are as follows. 


o 2 Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 
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Qe MMe MH AOL O 
—mm COMA DN ALN AN AHN A 


nl Ma 


a | 


> 


0 
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Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the standard escape convention where control charac- 
ters are printed as “X and the delete character is printed as*?. 

Print the addressed characters until a zero character is reached. 

Print a string using the “X escape convention (see C above). 7 is the length of the string 
including its zero terminator. 

Print 4 bytes in date format (see ctime(3)). 

Print as machine instructions. n is the number of bytes occupied by the instruction. This 
style of printing causes variables 1 and 2 to be set to the offset parts of the source and 
destination respectively. 

Print the value of dot in symbolic form. Symbols are checked to ensure that they have an 
appropriate type as indicated below. 


local or global data symbol 
local or global text symbol . 
local or global absolute symbol 


Print the addressed value in symbolic form using the same rules for symbol lookup as a. 
When preceded by an integer tabs to the next appropriate tab stop. For example, 8t 


~ moves to the next 8-space tab stop. 


Print a space. 

Print a newline. 

Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 
Dot is incremented by 1. Nothing is printed. 

Dot is decremented by 1. Nothing is printed. 


newline Repeat the previous command with a count of 1. 


[2/]l value mask 


[?/w value ... 
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Words starting at dot are masked with mask and compared with value until a match is found. If L 
is used then the match is for 4 bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask is omitted then —1 is used. 


Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. Odd 
addresses are not allowed when writing to the subprocess address space. 


(?/Jm b/ el f1[?/) 

New values for (b/, el, f1) are recorded. If less than three expressions are given then the remain- 
ing map parameters are left unchanged. If the ‘?’ or ‘/’ is followed by ‘*’ then the second seg- 
ment (b2 ,e2 ,f2) of the mapping is changed. If the list is terminated by ‘?’ or ‘/’ then the file 
(objfl or corfil respectively) is used for subsequent requests. (So that, for example, ‘/m?’ will 
cause ‘/’ to refer to objfil.) : 
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>name_ Dot is assigned to the variable or register named. 
A shell (/bin/sh) is called to read the rest of the line following ‘!’. 


{ 


$modifier . 
Miscellaneous commands. The available modifiers are: 


J 


<f 


>f 


? 


ao 


wH< mong o 


smodifier 
Manage a subprocess. Available modifiers are: 
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be 


cs 


Read commands from the file f. If this command is executed in a file, further commands 
in the file are not seen. If fis omitted, the current input stream is terminated. If a count is 
given, and is zero, the command will be ignored. The value of the count will be placed in 
variable 9 before the first command in fis executed. 

Similar to < except it can be used in a file of commands without causing the file to be 
closed. Variable 9 is saved during the execution of this command, and restored when it 
completes. There is a (small) finite limit to the number of << files that can be open at 
once. 

Append output to the file f, which is created if it does not exist. If fis omitted, output is 
returned to the terminal. 

Print process id, the signal which caused stoppage or termination, as well as the registers 
as $r. This is the default if modifier is omitted. 

Print the general registers and the instruction addressed by pce. Dot is set to pc. 

Print all breakpoints and their associated counts and commands. 

C stack backtrace. If address is given then it is taken as the address of the current frame 
instead of the contents of the frame—pointer register. If C is used then the names and (32 
bit) values of all automatic and static variables are printed for each active function. (bro- 
ken on the VAX). If count is given then only the first count frames are printed. 

Set the default radix to address and report the new value. Note that address is interpreted 
in the (old) current radix. Thus ‘‘10$d’’ never changes the default radix. To make 
decimal the default radix, use ‘‘0t10$d’’. 

The names and values of external variables are printed. 

Set the page width for output to address (default 80). 

Set the limit for symbol matches to address (default 255). 

All integers input are regarded as octal. 

Exit from adb. 

Print all non zero variables in octal. 

Print the address map. 

(Kernel debugging) Change the current kernel memory mapping to map the designated 
user structure to the address given by the symbol u. The address argument is the 
address of the user’s user page table entries (on the VAX). 


Set breakpoint at address. The breakpoint is executed count—1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com- 
mand is omitted or sets dot to zero then the breakpoint causes a stop. 


Delete breakpoint at address. 


Run objfil as a subprocess. If address is given explicitly then the program is entered at 
this point; otherwise the program is entered at its standard entry point. count specifies 
how many breakpoints are to be ignored before stopping. Arguments to the subprocess 
may be supplied on the same line as the command. An argument starting with < or > 
causes the standard input or output to be established for the command. 


The subprocess is continued with signal s, see sigvec(2). If address is given then the sub- 
process is continued at this address. If no signal is specified then the signal that caused 
the subprocess to stop is sent. Breakpoint skipping is the same as for r. 
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Ss As for ¢ except that the subprocess is single stepped count times. If there is no current 
subprocess then objfil is run as a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the subprocess. 


k The current subprocess, if any, is terminated. 


VARIABLES 


Adb provides a number of variables. Named variables are set initially by adb but are not used subse- 
quently. Numbered variables are reserved for communication as follows. 


0 The last value printed. 


1 The last offset part of an instruction source. 
2 The previous value of variable 1. 
9 The count on the last $< or $<< command. 


On entry the following are set from the system header in the corfil. If corfil does not appear to be a core 
file then these values are set from objfil. 


b The base address of the data segment. 
d The data segment size. 
e The entry point. 
m The ‘magic’ number (0407, 0410 or 0413). 
s The stack segment size. 
t The text segment size. 
ADDRESSES 


FILES 


The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by two triples (b/, el, f1) and (b2, e2, f2) and the file address corresponding 
to a written address is calculated as follows. 


bl <address<e] => file address=address +f1—b1, otherwise, 
- b2sSaddress<e2 => file address=address+f2—b2, 


otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I and D 
space) the two segments for a file may overlap. If a? or / is followed by an * then only the second triple is 
used. . 


The initial setting of both mappings is suitable for normal a.out and core files. If either file is not of the 
kind expected then, for that file, b] is set to 0, e] is set to the maximum file size and f7 is set to 0; in this 
way the whole file can be examined with no address translation. 


a.out 
core 


SEE ALSO 


cc(1), dbx(1), ptrace(2), a.out(5), core(5) 


DIAGNOSTICS 


BUGS 


‘Adb’ when there is no current command or format. Comments about inaccessible files, syntax errors, 
abnormal termination of commands, etc. Exit status is 0, unless last command failed or returned nonzero 
Status. 


Since no shell is invoked to interpret the arguments of the :r command, the gustomaly wild-card and vari- 
able expansions cannot occur. 
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NAME 


addbib — create or extend bibliographic database 


SYNOPSIS 


addbib [ options] database 


DESCRIPTION — 


When this program starts up, answering ‘‘y’’ to the initial ‘‘Instructions?’’ prompt yields directions; typing 
“‘n”’ or RETURN skips them. Addbib then prompts for various bibliographic fields, reads responses from 
the terminal, and sends output records to a database. A null response (just RETURN) means to leave out that 
field. A minus sign (—) means to go back to the previous field. A trailing backslash allows a field to be 
continued on the next line. The repeating ‘‘Continue?’’ prompt allows the user either to resume by typing 
“*y’’ or RETURN, to quit the current session by typing ‘‘n’’ or ‘‘q’’, or to edit the database with any system 
editor (vi, ex, edit, ed). . 


By default, addbib prompts for an abstract. You can suppress this prompt with the —a option described 
below. To end an abstract, type CTRL-d. 


The most common key-letters and their meanings are given below. Addbib insulates you from these key- 
letters, since it gives you prompts in English, but if you edit the bibliography file later on, you will need to 
know this information. 


%A Author’s name 

%B Book containing article referenced 

%C City (place of publication) 

%D Date of publication 

%E Editor of book containing article referenced 
%F Footnote number or label (supplied by refer ) 
%G Government order number 

%H Header commentary, printed before reference 
%l Issuer (publisher) 

%J Journal containing article 

%K Keywords to use in locating reference 

%L Label field used by —k option of refer 

%M Bell Labs Memorandum (undefined) 

%N Number within volume 

%O Other commentary, printed at end of reference 
%P Page number(s) 

%Q Corporate or Foreign Author (unreversed) 
%R Report, paper, or thesis (unpublished) 

%S Series title 

%T Title of article or book 

%V Volume number 

%X Abstract — used by roffbib, not by refer 
%Y,Z ignored by refer 


Except for ‘A’, each field should be given just once. Only relevant fields should be supplied. An example 
is: 


%A Bill Tuthill 
%T Refer — A Bibliography System 


GI Computing Services 
%C Berkeley 
%D 1982 


%O UNX 4.3.5. 
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OPTIONS | 
—a Suppresses prompting for an abstract. 
—p promptfile 
Causes addbib to use a new prompting skeleton, defined in the specified promptfile. This file 
should contain prompt strings, a tab, and the key-letters to be written in the database. 
FILES 


promptfile optional file to define prompting 


SEE ALSO | 
refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1) 
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NAME 


apply — apply a command to a set of arguments 


SYNOPSIS 


apply [ —ac } [— ] command args ... 


DESCRIPTION 


Apply runs the named command on each argument arg in turn. Normally arguments are chosen singly; the 
optional number x specifies the number of arguments to be passed to command. If n is zero, command is 
run without arguments once for each arg. Character sequences of the form %d in command, where d is a 
digit from 1 to 9, are replaced by the d’th following unused arg. If any such sequences occur, n is ignored, 
and the number of arguments passed to command is the maximum value of d in command. The character 
“%’ may be changed by the —a option. 


Examples: 
apply echo * 
is similar to Is(1); 
apply —2 cmp al b1 a2 b2... 
compares the ‘a’ files to the ‘b’ files; 
apply -0 who 12345 
runs who(1) 5 times; and 
apply ‘In %1 /usr/joe’ * 
links all files in the current directory to the directory /usr/joe. 


SEE ALSO 


BUGS 


sh(1) 


Shell metacharacters in command may have bizarre effects; it is best to enclose complicated commands in 
single quotes °°. 


There is no way to pass a literal ‘%2’ if ‘%’ is the argument expansion character. 
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NAME 
apropos — locate commands by keyword lookup 


SYNOPSIS 
apropos keyword ... 


DESCRIPTION 
Apropos shows which manual sections contain instances of any of the given keywords in their title. Apro- 
pos considers each word separately and ignores the case of letters. Apropos also considers words that are 
part of other words: when looking for compile, apropos will find all instances of ‘compiler’ also. (Try 
“apropos password" and “apropos editor" to see how apropos does this.) 
If the line starts ‘name(section) ...’ you can do ‘man section name’ to get the documentation for it. Try 
‘apropos format’ and then ‘man 3s printf’ to get the manual on the subroutine print. 


Apropos is actually just the —k option to the man(1)} command. 


FILES 
/ust/man/whatis data base 


SEE ALSO 
man(1), whatis(1), catman(8) 
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NAME 
as — MC68000/MC68010/MC68020 assembler 


SYNOPSIS 
as [ options | [ files ] 
DESCRIPTION 
As assembles the named files, or the standard input if no files are specified. 


OPTIONS 
-L Saves defined labels beginning with ‘‘L,’’ which are normally discarded to save space in the 
resultant symbol table. The compilers generate such temporary labels. 


—0 objfile Name of output file. 


—-R Makes initialized data segments read-only, by concatenating them to the text segments. 
This obviates the need to run editor scripts on assembly code to make initialized data read- 
only and shared. . 

—-W Suppresses error messages. 

—20 Accepts 68020 extended instruction set. 


All undefined symbols in the assembly are treated as global. 
The output of the assembly is left in the objfile; if that is omitted, a.out is used. 


FILES 
/tmp/as* default temporary files 
a.out default resultant object file 
SEE ALSO 


Id(1), nm(1), adb(1), dbx(1), a.out(5) 
Assembler Reference Manual in UNIX Programmer's Supplementary Documents, Volume I. 
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NAME 


ar — archive and library maintainer 
SYNOPSIS 

ar key { posname ] afilename ... 
DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 

files as used by the loader. It can be used, though, for any similar purpose. N.B: This version of ar uses an 

ASCIl-format archive that is portable among the various machines running UNIX. Programs for dealing 

with older formats are available: see arcv(8). . 

Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibclo. Afile is 

the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used with r, then only 
those files with ‘last-modified’ dates later than the archive files are replaced. If an optional posi- 
tioning character from the set abi is used, then the posname argument must be present and 
specifies that new files are to be placed after (a) or before (b or i) posname. Otherwise new files 
are placed at the end. 

q Quickly append the named files to the end of the archive file. Optional positioning characters are 
invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the archive are 
tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is present, then the 
posname argument must be present and, as in r, specifies where the files are to be moved. 

x Extract the named files. If no names are given, all files in the archive are extracted. In neither 
case does x alter the archive file. Normally the ‘last-modified’ date of each extracted file is the 
date when it is extracted. However, if o is used, the ‘last-modified’ date is reset to the date 
recorded in the archive. 

v Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 
archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with p, it precedes each file with a name. 

c Create. Normally ar will create afile when it needs to. The create option suppresses the normal 
message that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 
placed in the local directory. 

FILES | 


/temp/v* temporaries 
SEE ALSO | 
lorder(1), Id(1), ranlib(1), ar(5), arcv(8) 
BUGS 
If the same file is mentioned twice in an argument list, it may be put in the archive twice. 
The ‘last-modified’ date of a file will not be altered by the o option if the user is not the owner of the 


extracted file, or the super-user. 
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at — execute commands at a later time 


SYNOPSIS 


at [ options ] time [ day] [ file} 


DESCRIPTION 


At spools away a copy of the named file to be used as input to sh(1) or csh(1). If no shell is specified, at 
executes the job in the current environment shell. If no filename is specified, at prompts for commands 
from standard input until a “D is typed. 


The format of the spool file is as follows: A four line header that includes the owner of the job, the name 
of the job, the shell used to run the job, and whether mail will be set after the job is executed. The header is 
followed by a cd command to the current directory and a umask command to set the modes on any files 
created by the job. Then at copies all relevant environment variables to the spool file. When the script is 
run, it uses the user and group ID of the creator of the spool file. 

The time is 1 to 4 digits, with an optional following ‘A’, ‘P’, ‘N’ or ‘M’ for AM, PM, noon or midnight. 
At interprets one and two digit numbers as hours and three and four digits to be hours and minutes. If no 
letters follow the digits, a 24 hour clock time is understood. 


The optional day is either (1) a month name followed by a day number, or (2) a day of the week; if the 
word ‘week’ follows, invocation is moved seven days further off. Names of months and days may be 
recognizably truncated. Examples of legitimate commands are 


at 8am jan 24 
at -c -m 1530 fr week 
at -s -m 1200n week 


At programs are executed by periodic execution of the command /usr/lib/atrun from cron(8). The granu- 
larity of at depends upon the how often atrun is executed. 


OPTIONS 


FILES 


—C Tells at to execute the job in csh (1). 
—s Tells at to execute the job in sh (1). 


—m Sends mail to the user after the job has been run. If errors occur during execution of the job, a 
copy of the error diagnostics will be sent to the user. If no errors occur, then a short message is 
sent informing the user that no errors occurred. 


/ust/spool/at spooling area 
/usr/spool/at/yy.ddd.hhhh.* job file 

/usr/spool/at/past directory where jobs are executed from 
/usr/spool/at/lasttimedone _last time atrun was run 

/usr/lib/atrun executor (run by cron (8)) 


SEE ALSO 


atq(1), atrm(1), calendar(1), sleep(1), cron(8) 


DIAGNOSTICS 


BUGS 


Complains about various syntax errors and times out of range. 


Due to the granularity of the execution of fusr/ib/atrun, there may be bugs in scheduling things almost 
exactly 24 hours into the future. 


If the system crashes, mail is not sent to the user informing them that the job was not completed. 


Sometimes old spool files are not removed from the directory /usr/spool/at/past. This is usually due to a 
system crash, and requires that they be removed by hand. 
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NAME 

atq — print the queue of jobs waiting to be run 
SYNOPSIS 

atq [ options | [ name ... ] 


DESCRIPTION . 
Atg prints the queue of jobs that are waiting to be run at a later date. When executed without flags, atq 
prints the queue in the orde< that the jobs will be executed. These jobs were created with the at(1) com- 
mand. 

If a name is provided, atq displays only those files belonging to that user. You can specify more than one 
name. 

OPTIONS 
—C Sorts the queue by the time that the at command was given. 


—n Prints only the total number of files that are currently in the queue. 


FILES 
/usr/spool/at spool area 


SEE ALSO 
at(1), atrm(1), cron(8) 
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NAME 

atrm — remove jobs spooled by at 
SYNOPSIS 

atrm [ options] [ [ job #} [name }...] 


DESCRIPTION 
Atrm removes jobs that were created with the at(1) command. 


If a job number(s) is specified, atrm attempts to remove only that job(s). Similarly, if a user name(s) is 
specified, atrm removes all jobs belonging to that user(s). Because regular users can remove all their own 
jobs with the - option, this form of invoking atrm is useful only to the super-user. 


OPTIONS 
- Removes all jobs belonging to the person invoking atrm. 
—f Suppresses all information regarding the removal of the specified jobs. 
-i atrm asks if a job should be removed. Responding ’y’ removes the job. 


FILES 
/ust/spool/at spool area 


SEE ALSO 
at(1), atq(1), cron(8) 
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NAME 
7 awk — pattern scanning and processing language 
SYNOPSIS 
awk [—Fe ] [ prog ] [ file}... 


DESCRIPTION 
Awk scans each input file for lines that match any of a set of patterns specified in prog. With each pattern 
in prog there can be an associated action that will be performed: when a line of a file matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as -f file. 


Files are read in order; if there are no files, the standard input is read. The filename ‘—’ means the standard 
input. Each line is matched against the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 


An input line is made up of fields separated by white space. (This default can be changed by using FS, vide 
infra.) The fields are denoted $1, $2, ... ; $0 refers to the entire line. 


A pattern-action statement has the form 

pattern { action } 
A missing { action } means print the line; a missing pattern always matches. 
An action is a sequence of statements. A statement can be one of the following: 


if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, newlines or right braces. An empty expression-list stands for the 
whole line. Expressions take on string or numeric values as appropriate, and are built using the operators 
+, —, *,/, %, and concatenation (indicated by a blank). The C operators ++, —, +=, —=, *=, /=, and %= are 
also available in expressions. Variables may be scalars, array elements (denoted x[i]) or fields. Variables 
are initialized to the null string. Array subscripts may be any string, not necessarily numeric; this allows 
for a form of associative memory. String constants are quoted ...”. 


The print statement prints its arguments on the standard output (or on a file if >file is present), separated by 
the current output field separator, and terminated by the output record separator. The printf statement for- 
mats its expression list according to the format (see printf(3s)). 


The built-in function length returns the length of its argument taken as a string, or of the whole line if no 
argument. There are also built-in functions exp, log, sqrt, and int. The last truncates its argument to an 
integer. substr(s, m,n) returns the n-character substring of s that begins at position m. The function 
sprintf(fmt, expr, expr, ...) formats the expressions according to the printf(3s) format given by fmt and 
returns the resulting string. 

Patterns are arbitrary Boolean combinations (!, ||, &&, and parentheses) of regular expressions and rela- 
tional expressions. Regular expressions must be surrounded by slashes and are as in egrep. Isolated regu- 


lar expressions in a pattern apply to the entire line. Regular expressions may also occur in relational 
expressions. 
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A pattern may consist of two patterns separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and the next occurrence of the second. 
A relational expression is one of the following: 

expression matchop regular-expression 

expression relop expression 
where a relop is any of the six relational operators in C, and a matchop is either ~ (for contains) or !~ (for 
does not contain). A conditional is an arithmetic expression, a relational expression, or a Boolean combi- 
nation of these. 


The special patterns BEGIN and END may be used to capture control before the first input line is read and 
after the last. BEGIN must be the first pattern, END the last. 


A single character c may be used to separate the fields by starting the program with 
BEGIN { FS = "c" } 
or by using the —Fc option. 
Other variable names with special meanings include NF, the number of fields in the current record; NR, the 
ordinal number of the current record; FILENAME, the name of the current input file; OFS, the output field 


separator (default blank); ORS, the output record separator (default newline); and OFMT, the output for- 
mat for numbers (default "%.6g"). 


EXAMPLES 


Print lines longer than 72 characters: 
length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Add up first column, print sum and average: 


{s+=$1} 
END _{ print "sum is", s, " average is", s/NR } 
Print fields in reverse order: 


{ for (i = NF; i > 0; —i) print $i } 

Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 


SEE ALSO 


BUGS 


lex(1), sed(1) 3 | 
A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk — a pattern scanning and processing language 


There are no explicit conversions between numbers and strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string concatenate "" to it. 
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NAME 

basename - strip filename affixes 
SYNOPSIS . 

basename string[ suffix] 


DESCRIPTION 
Basename deletes the specified suffix, as well as any prefix ending in ‘/’, from string, and prints the result 
on the standard output. It is normally used inside substitution marks ~ ~ in shell procedures. 


This shell procedure invoked with the argument /usr/src/bin/cat.c compiles the named file and moves the 
output to cat in the current directory: 


cc $1 
mv a.out “basename $1 .c* 


SEE ALSO 
sh(1) 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be [ options } [ file ... ] 


DESCRIPTION 
Bc is an interactive processor for a language which resembles C but provides unlimited precision arith- 
metic. It takes input from any files given, then reads the standard input. The —1 argument stands for the 
name of an arbitrary precision math library. The syntax for be iia is as follows: L means letter a-z, 
E means expression, S means statement. 


Comments 
are enclosed in /* and */. 


Names 
simple variables: L 
array elements: L [ E ] 
The words ‘ibase’, ‘obase’, and ‘scale’ 

Other operands 
arbitrarily long numbers with optional sign and decimal point. 
(E) 
sqrt (E ) 
length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
L(Ey«asE) 


Operators 
+-— * / % *(% is remainder; * is power) 
140: (prefix and postfix; apply to names) 


== <= >= != < > 


while (E)S 

for(E;E;E)S 

null statement 

break 

quit 

Function definitions 

define L(L.,...,L) { 
auto L, ..., L 
S08 
return (E ) 

} 


Functions in —I math library (see next page for option) 
S(x) sine 
c(x) cosine 
e(x) exponential 
I(x) log 
a(x) arctangent 
j(m,x) Bessel function 
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All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assignment. Either 

semicolons or newlines may separate statements. Assignment to scale influences the number of digits to be 

retained on arithmetic operations in the manner of dc(1). Assignments ae aca a 
- Output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable simultaneously. All variables 
are global to the program. ‘Auto’ variables are pushed down during function calls. When using arrays as 
function arguments or defining them as automatic variables empty square brackets must follow the array 


name. 
For example 
scale = 20 
define e(x){ 
auto a, b, c, i, s 
a=1 
b=1 
s=1 
for(i=1; 1==1; i++){ 
a= a*x 
b = bti 
c=a/b 
if(c == 0) return(s) 
S=S+C 
} 
} 


defines a function to compute an approximate value of the exponential function and 
for(i=1; i<=10; i++) e(i) . 
prints approximate values of the exponential function of the first ten integers. 


Bc is actually a preprocessor for dc(1), which it invokes automatically, unless the —c (compile only) option 
is present. In this case the dc input is sent to the standard output instead. 


OPTIONS 

-l Invokes an arbitrary precision math library. 
FILES 

/usr/lib/lib.b mathematical library 

dc(1) desk calculator proper 
SEE ALSO 

de(1) 


L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator language 


BUGS 
Bc does not have &&, ||, or ! operators. 
For statements must have all three E’s. 
Quit is interpreted when read, not when executed. 
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NAME 
biff — be notified if mail arrives and who it is from 

SYNOPSIS 
biff [ options ] 

DESCRIPTION 
Biff informs the system whether you want to be notified when mail arrives during the current terminal ses- 
sion. 
Typing biff without options prints the value of biff—y or n depending on whether notification is enabled or 
disabled. | 
When mail notification is enabled, the header and first few lines of the message will be printed on your 
screen whenever mail arrives. A ‘‘biff y’’ command is often included in the file login or .profile to be exe- 
cuted at each login. 


Biff operates asynchronously. For synchronous notification use the MAIL variable of sh(1) or the mail 
variable of csh(1). 


OPTIONS 
“y Enables mail notification. 


-n Disables mail notification. 


SEE ALSO : 
csh(1), sh(1), mail(1), comsat(8C) 
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NAME 


binmail — send or receive mail among users 


SYNOPSIS 


/bin/mail [ options } [ person ]... 
/bin/mail [ options } file 


DESCRIPTION 


Note: This is the old version 7 UNIX system mail program. The default mail command is described in 
Mail(1), and its binary is in the directory /ust/ucb . 


mail with no argument prints a user’s mail, message-by-message, i in last-in, first-out order. The optional 
argument + displays the mail messages in first-in, first-out order. For each message, it reads a line from the 
standard input to direct disposition of the message. . 


Once you’ve invoked mail, you can use these commands: 
newline Go on to next message. 

d Delete message and go on to the next. 

p Print message again. 

- Go back to previous message. 


s [file]... 
Save the message in the named files (‘mbox’ default). 


w [fille }... 
Save the message, without a header, in the named files (‘mbox’ default). 
m [ person }... 
Mail the message to the named persons (yourself is default). 
EOT (control-D) 
Put unexamined mail back in the mailbox and stop. 
q Same as EOT. 
!command 
Escape to the Shell to execute command. 
* Print a command summary. 
An interrupt normally terminates the mail command and leaves the mail file unchanged. The optional 
argument —i tells mail to continue after interrupts. 


When persons are named, mail takes the standard input up to an end-of-file (or a line with just *.’) and 
adds it to each person’s ‘mail’ file. The sender’s name and a postmark precede each message. Lines that 
look like postmarks are prepended with ‘>’. Usually person is a user name recognized by login(1). To 
denote a recipient on a remote system, prefix person by the system name and exclamation mark (see 
uucp(1C)). 


When a user logs in, mail tells him if he has received any messages. 


OPTIONS 


FILES 


-f Prints the named file, as if it were the mail file. For example, /bin/mail -f mbox prints the file 
mbox as the mail file. 

-i Tells mail to continue after interrupts. 

+ Displays mail messages in first-in, first-out order. 

/etc/passwd to identify sender and locate persons 

/ust/spool/mail/* incoming mail for user * 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


BINMAIL (1) UNIX Programmer’s Manual BINMAIL (1) 


mbox saved mail 
/tmp/ma* temp file 
/ust/spool/mail/*.lock lock for mail directory 
dead. letter unmailable text 

SEE ALSO 


Mail(1), write(1), uucp(1C), wux(1C), xsend(1), sendmail(8) 


BUGS 
Race conditions sometimes result in a failure to remove a lock file. 


Normally anybody can read your mail, unless it is sent by xsend(1). An installation can overcome this by 
making mail a set-user-id command that owns the mail directory. 
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NAME 
cal — print calendar 
SYNOPSIS 
cal [ month ] year 
DESCRIPTION 
Cal prints a calendar for the specified year. If you specify a month with the year, cal prints a calendar just 
for that month. Year can be between 1 and 9999. The month is a number between 1 and 12. The calendar 
produced is that for England and her colonies. 
Try September 1752. 
BUGS 
The year is always considered to start in January even though this is historically naive. 
Beware that ‘cal 78’ refers to the early Christian era, not the 20th century. 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


CALENDAR (1) UNIX Programmer’s Manual CALENDAR (1) 


NAME 
calendar — reminder service 

SYNOPSIS 
calendar [ — } 

DESCRIPTION 
Calendar consults the file ‘calendar’ in the current directory and prints out lines that contain today’s or 
tomorrow’s date anywhere in the line. Calendar recognizes most reasonable month-day dates such as 
‘Dec. 7,’ ‘december 7,’ ‘12/7,’ etc., but not ‘7 December’ or ‘7/12’. If you specify the month as ‘‘*’’ with 
a date, i.e. ‘‘* 1’’, that day in any month will do. On weekends ‘tomorrow’ extends through Monday. 
When an argument is present, calendar does its job for every user who has a file ‘calendar’ in his login 
directory and sends him any positive results by mail(1). Normally this is done daily in the wee hours under 
control of cron(8). 
The file ‘calendar’ is first run through the ‘‘C’’ preprocessor, /lib/cpp , to include any other calendar files 
specified with the usual “‘#include’’ syntax. Included calendars will usually be shared by all users, main- 
tained and documented by the local administration. 

FILES 
calendar 
/usr/lib/calendar to figure out today’s and tomorrow’s dates 
/etc/passwd 
/tmp/cal* 
/lib/cpp, egrep, sed, mail as subprocesses 

SEE ALSO 
at(1), cron(8), mail(1) 

BUGS 


Calendar’s extended idea of ‘tomorrow’ doesn’t account for holidays. 
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NAME 
cat — catenate and print 


SYNOPSIS 
cat [ options ] file ... 
DESCRIPTION ; . 
Cat reads each file in sequence and displays it on the standard output. Thus 


Cat file 
displays the file on the standard output, and 
Cat file1 file2 >file3 
concatenates the first two files and places the result on the third. 


If you do not specify an input file or if you use the argument ‘—’, cat reads from the standard input file. 
Output is buffered in the block size recommended by stat (2) unless the standard output is a terminal, when 
it is line buffered. 


OPTIONS 
—b When used with the —n option, omits the line numbers from blank lines. 


—e When used with -v, displays a ‘$’ character at the end of each line. 

—n Displays the output lines preceded by lines numbers, numbered sequentially from 1. 
—Ss Crushes out multiple adjacent empty lines so that the output is displayed single spaced. 
-t When used with -v, displays tab characters as “I. 

—u Makes the output completely unbuffered. 


-v Displays non-printing characters so that they are visible. Control characters print like “X for 
control-x; the delete character (octal 0177) prints as “?. Non-ascii characters (with the high bit 
set) are printed as M- (for meta) followed by the character of the low 7 bits. 


SEE ALSO | 
cp(1), ex(1), more(1), pr(1), tail(1) 


BUGS 
Beware that ‘cat a b >a’ and ‘cat a b >b’ destroy input files before reading them. 
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NAME 

cb —C program beautifier 
SYNOPSIS 

cb 


DESCRIPTION 
Cb places a copy of the C program from the standard input on the standard output with spacing and inden- 
tation that displays the structure of the program. 
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NAME 

cc — C compiler 
SYNOPSIS 

cc [ options ] files 
DESCRIPTION 

Cc is an optimizing C compiler. It accepts several types of arguments. 

Arguments whose names end with ‘.c’ are C source programs. They are compiled and left in a ‘.o’ file in 

the working directory. 

Arguments whose names end with ‘.s’ are assembly language source programs. They are assembled and 

left in a ‘.o’ file in the working directory. 

The ‘.0’ file is deleted if a single source file is compiled and linked. 

Cc creates *.s’ files for each module only the user compiles with the —S option. 

OPTIONS 

Cc accepts the options listed below. Additional options are supported by Id(1). 

—20 Generates code for a 68020 CPU. To maintain compatibility with old code, the alignment rules 
are not changed unless you include the option -X134 on the command line. This alignment 
forces longwords to 32 bit boundaries, and cannot be used with programs which include 
stdio.h. 

—C Compiles to the ‘.o’ level only. Does not link. 

-C Does not strip comments from the preprocessor output. Must be used with the —E option. 

~—Dname=def 

—Dname Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". 

—-E Does not compile the program. Instead, this option places the output of the preprocessor in the 
standard output file. This is useful for debugging preprocessor macros. The integrated prepro- 
cessor cannot generate output as fast as cpp(1), so use epp(1) for big jobs. 

-f Generates code which assumes the presence of a 68881 coprocessor. By default many of the 
functions supported by the 68881 will be inline as well; use -Z129 if you want a transcendental 
call to go to the routine instead. 

-g Generates BSD style debugger information in the assembly file for use with a debugger such 
as dbx(2). 

—ga Generates a stack frame for every routine, regardless of need. 

—-k Prevents the compiler from optimizing an "and" with a single bit into a BTST instruction. 
(Some I/O devices require word access to their registers while BTST is a byte access instruc- 
tion.) 

—Idir "#include"s files whose names do not begin with ‘/’ are always sought first in the directory of 
the file argument, then in directories named in —I options, then in /usr/include. 

—0 output Names the final output file ourput. If this option is used, the file a.out will be left undisturbed. 

-O Performs various speed optimizations, such as moving constant expressions out of loops. Gen- 
erally this makes your programs somewhat larger; if their performance is not loop bound, they 
may become slower as well. 

-—O2 Allows the optimizer to assume that memory locations do not change except by explicit stores. 
That is, it guarantees the optimizer that no memory locations are I/O device registers that can 
be changed by external hardware and no memory locations are being shared with other 
processes which can change them asynchronously with respect to the current process. Use this 
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compile time option with extreme caution (or not at all) in device drivers, operating systems, 
shared memory environments, and when interrupts (or UNIX signals) are present. 


-p Generates profiling code and links the code with routines which support prof(1). 

—pg Generates profiling code similar to —p, but links with a more comprehensive profiling mechan- 
ism which supports gprof(1). 

-R Makes initialized variables part of the text segment. Passed on to as. 

-S Compiles the named C programs and leaves the assembler-language output on corresponding 
files suffixed ‘.s’. 

-Uname Remove any initial definition of name. 

-Vv Turns on verbose mode. Prints out the arguments to each phase of compilation and linking. 

-Ww Suppresses warning messages. 

—Xn Where 7 is an integer constant, turns on option number n. There are numerous options avail- 
able for such things as signed bit fields, short return types, etc. You can find descriptions of 
these options in Section 8 of the UNIX Compiler Guide: C, Pascal, FORTRAN 77. 

-Zn Turns off option number n. This is the reverse of the X option. This option is useful for turn- 
ing off options that are on by default. 

FILES 

file.[cs] input file 

file.o object file 

a.out loaded output 

/bin/as assembler 

/lib/cpp C preprocessor 

/lib/crt0.o startup code 

/usr/lib/ccom C compiler 

/usr/include standard directory for ’#include’ header files 

/usr/lib/libc.a UNIX standard I/O library 

/usr/lib/libe_p.a profiling UNIX standard I/O library 

/usr/lib/libmc.a UNIX standard I/O library for the 68020/68881 

/usr/lib/libme_p.a profiling UNIX standard I/O library for the 68020/6888 1 

/usr/lib/gcrt0.0* profiling startup code for gprof(1) 

/lib/mcrt0.o* profiling startup code for prof(1) 

/usr/lib/libm.a transcendental floating point math library 

/usr/lib/libm_p.a profiling trancendental floating point library 

/usr/lib/libmm.a 68020/68881 trancendental floating point math library 

/usr/lib/libmm_p.a 68020/68881 trancendental floating point math library 

/usr/lib/libskyc.a standard I/O library compiled for sky FFP 

/usr/lib/libskyc_p.a profiling standard I/O library compiled for Sky FFP 

/usr/lib/libskym.a transcendental math library for Sky FFP 

/usr/lib/libskym_p.a profiling transcendental math library for Sky FFP 

/usr/lib/skycrt0.0* startup code for the Sky FFP 


/usr/lib/skygcrt0.o* Sky profiling startup routine for gprof(1) profiling 
/usr/lib/skymcrt0.o* Sky profiling for prof(1) startup 


SEE ALSO 


B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
B. W. Kernighan, Programming in C—a tutorial 

D. M. Ritchie, C Reference Manual 

UNIX Compiler Guide: C, Pascal, FORTRAN 77 

as(1), prof(1), gprof(1), adb(1), dbx(1), Id(1), f77(1), pe(1) 
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DIAGNOSTICS | 
The diagnostics produced by the C compiler are intended to be self-explanatory and similar to those pro- 
duced by the BSD compiler. Occasional messages may be produced by the assembler or loader. 
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NAME 
cd — change working directory 

SYNOPSIS 
cd directory 

DESCRIPTION 
Directory becomes the new working directory. The process must have execute (search) permission in 
directory. 
Because a new process is created to execute each command, cd would be ineffective if it were written as a 
normal command. It is therefore recognized and executed by the shells. In csh(1) you may specify a list of 
directories in which directory is to be sought as a subdirectory if it is not a subdirectory of the current 
directory; see the description of the cdpath variable in csh(1). 

SEE ALSO 
esh(1), sh(1), pwd(1), chdir(2) 


_ April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


CHECKNR (1) UNIX Programmer’s Manual CHECKNR (1) 


NAME 
checknr — check nroff/troff files 
SYNOPSIS 
checknr [ options } [ file } 
DESCRIPTION 
Checknr checks a list of mroff(1) or troff(1) input files for certain kinds of errors involving mismatched 
opening and closing delimiters and unknown commands. If no files are specified, checknr checks the stan- 
dard input. Delimeters checked are: 
(1) Font changes using \fx ... \fP. 
(2) Size changes using \sx ... \s0. 
(3) Macros that come in open ... close forms, for example, the .TS and .TE macros which must always 
come in pairs. 
Checknr knows about the ms(7) and me(7) macro packages. 
Checknr is intended to be used on documents that are prepared with checknr in mind, much the same as 
lint. It expects a certain document writing style for \f and \s commands, in that each \fx must be terminated 
with \fP and each \sx must be terminated with \sO. While it will work to directly go into the next font or 
explicitly specify the original font or point size, and many existing documents actually do this, such a prac- 
tice will produce complaints from checknr. Since it is probably better to use the \fP and \sO forms anyway, 
you should think of this as a contribution to your document preparation style. 
OPTIONS 
—axl yl .x2.y2.... xn.yn 
Add additional pairs of macros to the list. —a must be followed by groups of six characters, each 
group defining a pair of macros. The six characters are a period, the first macro name, another 
period, and the second macro name. For example, to define a pair ._BS and .ES, use —a.BS.ES 
—C.x1 x2.x3 ... xn 
Defines commands which would otherwise be complained about as undefined. 
—f Requests checknr to ignore \f font changes. 
—s Requests checknr to ignore \s size changes. 
SEE ALSO 
nroff(1), troff(1), checkeq(1), ms(7), me(7) 
DIAGNOSTICS 
Checknr complains about unmatched delimiters, unrecognized commands, and about command syntax. 
BUGS . 


There is no way to define a 1 character macro name using —a. 
Does not correctly recognize certain reasonable constructs, such as conditionals. 
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NAME 
chgrp — change group 
SYNOPSIS 
chgrp [ options } group file ... 
DESCRIPTION 
Chgrp changes the group-ID of the files to group. The group may be either a decimal GID or a group 
name found in the group-ID file. 


The user invoking chgrp must belong to the specified group and be the owner of the file, or be the super- 
user. 


OPTIONS 
—f Tells chgrp not to report errors ("force” option). 
-R Makes chgrp recursively descend its directory arguments setting the specified group-ID. When 
symbolic links are encountered, their group is changed, but they are not traversed. 
FILES 
/etc/group 


SEE ALSO 
chown(2), passwd(5), group(5) 
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chmod — change mode 


SYNOPSIS 


chmod [ options ] mode file ... 


DESCRIPTION 


The mode of each named file is changed according to mode, which may be absolute or symbolic. An abso- 
lute mode is an octal number constructed from the OR of the following modes: 


4000 
2000 
1000 
0400 
0200 
0100 
0070 
0007 


set user ID on execution 

set group ID on execution 

Sticky bit, see chmod(2) 

read by owner 

write by owner 

execute (search in directory) by owner 
read, write, execute (search) by group 
read, write, execute (search) by others 


A symbolic mode has the form: 


[who] op permission [op permission) ... 


The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). The letter a 
stands for all, or ugo. If who is omitted, the default is a but the setting of the file creation mask (see 
umask(2)) is taken into account. 


Op can be + to add permission to the file’s mode, — to take away permission and = to assign permission 
absolutely (all other bits will be reset). 


Permission is any combination of the letters r (read), w (write), x (execute), X (set execute only if file is a 
directory or some other execute bit is set), s (set owner or group id) and t (save text — sticky). Letters u, g, 
or 0 indicate that permission is to be taken from the current mode. Omitting permission is only useful with 
= to take away all permissions. . 


OPTIONS 
~f 


-R 


EXAMPLES 


Forces chmod not to complain if it fails to change the mode on a file. 


Makes chmod recursively descend its directory arguments setting the mode for each file as 
described above. When symbolic links are encountered, their mode is not changed and they are 
not traversed. 


The first example denies write permission to others, the second makes a file executable by all if it is execut- 
_ able by anyone: 


chmod o—w file 
chmod +X file 


Multiple symbolic modes separated by commas may be given. Operations are performed in the order 
specified. The letter s is only useful with u or g. 


Only the owner of a file (or the super-user) may change its mode. 


SEE ALSO 


Is(1), chmod(2), stat(2), umask(2), chown(8) 
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NAME 

clear — clear terminal screen 
SYNOPSIS 

clear 


DESCRIPTION 
Clear clears your screen if this is possible. It looks in the environment for the terminal type and then in 
/etc/termcap to figure out how to clear the screen. 

FILES 
/etc/termcap terminal capability data base 
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NAME 
cmp — compare two files 
SYNOPSIS 
cmp [ options } filel file2 
DESCRIPTION 
The two files are compared. (If file! is ‘—’, the standard input is used.) Under default options, cmp makes 
no comment if the files are the same; if they differ, it announces the byte and line number at which the 
difference occurred. If one file is an initial subsequence of the other, that fact is noted. 
OPTIONS . 
-l Print the byte number (decimal) and the differing bytes (octal) for each difference. 
—s Print nothing for differing files; return codes only. 
SEE ALSO 
diff(1), comm(1) 
DIAGNOSTICS 


Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argu- 
ment. 
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NAME 


col — filter reverse line feeds 


SYNOPSIS 


col [ options } 


DESCRIPTION 


Col reads the standard input and writes the standard output. It performs the line overlays implied by 
reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds (ESC-9 and ESC-8). Col is 
particularly useful for filtering multicolumn output made with the ‘.rt’ command of aroff and output result- 
ing from use of the tbl(1) preprocessor. . 


Although col accepts half line motions in its input, it normally does not emit them on output. Instead, text 
that would appear between lines is moved to the next lower full line boundary. This treatment can be 
suppressed by the -f (fine) option, described below. 


The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text in an alternate 
character set. The character set (primary or alternate) associated with each printing character read is 
remembered; on output, SO and SI characters are generated where necessary to maintain the correct treat- 
ment of each character. 


All control characters are removed from the input except space, backspace, tab, return, newline, ESC (033) 
followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an alternate form of full reverse 
line feed, for compatibility with some other hardware conventions. All other non-printing characters are 
ignored. 


OPTIONS 


—b Tells col to assume that the output device in use is not capable of backspacing. In this case, if 
several characters are to appear in the same place, only the last one read will be taken. 


—f Lets col include forward half lines in its output. The output can contain forward half line feeds 
(ESC-9), but never either kind of reverse line motion. 


—h Makes col convert white space to tabs to shorten printing time. 


SEE ALSO 


BUGS 


troff(1), tbi(1) 


Col can’t back up more than 128 lines. 
Col will not accept more than 800 characters, including backspaces, on a line. 
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NAME 
colert — filter nroff output for CRT previewing 


SYNOPSIS 
colcrt [ options | [file ...] 
DESCRIPTION 
Colcrt provides virtual half-line and reverse line feed sequences for terminals without such capability, and 
on which overstriking is destructive. Half-line characters and underlining (changed to dashing ‘—’) are 
placed on new lines in between the normal output lines. 
A typical use of colcrt would be 
tbl exum2.n | nroff —ms | colcrt — | more 
OPTIONS 
- Suppresses all underlining. It is especially useful for previewing allboxed tables from tbi(1). 


—2 Causes all half-lines to be printed, effectively double spacing the output. Normally, a minimal 
Space output format is used which will suppress empty lines. The program never suppresses two 
consecutive empty lines, however. The —2 option is useful for sending output to the line printer 
when the output contains superscripts and subscripts which would otherwise be invisible. 


SEE ALSO 
nroff/troff(1), col(1), more(1), ul(1) 


BUGS 
Should fold underlines onto blanks even with the ‘—’ option so that a true underline character would show; 
if we did this, however, colcrt wouldn’t get rid of cu’d underlining completely. 


Can’t back up more than 102 lines. 
General overstriking is lost; as a special case ‘|’ overstruck with ‘—’ or underline becomes ‘+’. 
Lines are trimmed to 132 characters. 


Some provision should be made for processing superscripts and subscripts in documents which are already 
double-spaced. 


May 7, 1986 INTEGRATED SOLUTIONS 4.3BSD 1 


COLRM (1) UNIX Programmer’s Manual COLRM (1) 


NAME 
colrm — remove columns from a file 


SYNOPSIS 
colrm [ startcol [ endcol } } 


DESCRIPTION 
Colrm removes selected columns from a file. Input is taken from standard input. Output is sent to stan- 
dard output. 


If called with one parameter the columns of each line will be removed starting with the specified column. 
If called with two parameters the columns from the first column to the last column will be removed. 


Column numbering starts with column 1. 


SEE ALSO 
expand(1) 
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NAME 

comm - select or reject lines common to two sorted files 
SYNOPSIS 

comm [ — [ 123] ] file] file2 
DESCRIPTION 


Comm reads file] and file2, which should be ordered in ASCII collating sequence, and produces a three 
column output: lines only in file! ; lines only in file2; and lines in both files. The filename ‘—’ means the 
standard input.. | 
Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm —12 prints only the lines com- 
mon to the two files; comm —23 prints only lines in the first file but not in the second; comm -—-123 is a no- 
op. 

SEE ALSO 
cmp(1), diff(1), umiq(1) 
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NAME 


compress, uncompress, zcat — compress and expand data 


SYNOPSIS 


compress [ options } [ —b bits ] { name ... } 
uncompress [ options } [{ name ... } 
zcat [ name ... } 


DESCRIPTION 


Compress reduces the size of the named files using adaptive Lempel-Ziv coding. Whenever possible, each 
file is replaced by one with the extension .Z, while keeping the same ownership modes, access and 
modification times. If no files are specified, the standard input is compressed to the standard output. 
Compressed files can be restored to their original form using uncompress or zcat. , 


The nondestructive behavior of zeat is identical to that of uncompress —c. See the OPTIONS section below. 


Compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for High Performance 
Data Compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 (June 1984), pp. 8-19. Common sub- 
Strings in the file are first replaced by 9-bit codes 257 and up. When code 512 is reached, the algorithm 
Switches to 10-bit codes and continues to use more bits until the limit specified by the —b flag is reached 
(default 16). Bits must be between 9 and 16. The default can be changed in the source to allow compress 
to be run on a smaller machine. 


After the bits limit is attained, compress periodically checks the compression ratio. If it is increasing, 
compress continues to use the existing code dictionary. However, if the compression ratio decreases, 
compress discards the table of substrings and rebuilds it from scratch. This allows the algorithm to adapt 
to the next “block” of the file. 


Note that the —b flag is omitted for uncompress, since the bits parameter specified during compression is 
encoded within the output, along with a magic number to ensure that neither decompression of random data 
nor recompression of compressed data is attempted. 


The amount of compression obtained depends on the size of the input, the number of bits per code, and the 
distribution of common substrings. Typically, text such as source code or English is reduced by 50-60%. 
Compression is generally much better than that achieved by Huffman coding (as used in pack), or adaptive 
Huffman coding (compact), and takes less time to compute. 


If an error occurs, exit status is 1, else if the last file was not compressed because it became larger, the 
Status is 2; else the status is 0. 


OPTIONS 


-¢e Makes compress or uncompress write to the standard output (like the catcommand). No files are 


changed. The nondestructive behavior of zeat is identical to that of uncompress -c. 


_f Forces compression of name, even if it does not actually sthirnk or the corresponding name Z file 
already exists. Except when run in the background under /bin/sh, if -f is not given the users is 
prompted as to whether an existing name.Z file should be overwritten. 


-v Prints the percentage reduction of each file. 


DIAGNOSTICS 


Usage: compress [—fvc] [—b maxbits] [file ...] 
Invalid options were specified on the command line. 
Missing maxbits . 
Maxbits must follow —b. 
file: not in compressed format 
The file specified to uncompress has not been compressed. 
file: compressed with xx bits, can only handle yy bits 
File was compressed by a program that could deal with more bits than the compress 
code on this machine. Recompress the file with smaller bits. 
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file: already has .Z suffix -- no change 
The file is assumed to be already compressed. Rename the file and try again. 

file: filename too long to tack on .Z 
The file cannot be compressed because its name is longer than 12 characters. Rename 
and try again. This message does not occur on BSD systems. 

file aieady exists; do you wish to overwrite (y orn)? 
Respond "y" if you want the output file to be replaced; "n" if not. 

uncompress: corrupt input 
A SIGSEGV violation was detected which usually means that the input file is cor- 
rupted. 

Compression: xx.xx% 


Percentage of the input saved by compression. (Relevant only for —v.) 
-- not a regular file: unchanged 


When the input file is not a regular file, (e.g. a directory), it is left unaltered. 
-- has xx other links: unchanged 


The input file has links; it is left unchanged. See In(1) for more information. 
-- file unchanged 


No savings is achieved by compression. The input remains virgin. 
BUGS 


Although compressed files are compatible between machines with large memory, —b12 should be used for 
file transfer to architectures with a small process data space (64KB or less, as exhibited by the DEC PDP 
series, the Intel 80286, etc.) 


Compress should be more flexible about the existence of the ‘.Z’ suffix. 
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NAME 
cp — copy 

SYNOPSIS 
cp [—ip ] file] file2 
cp [—ipr ] file ... directory 

DESCRIPTION 
Filel is copied onto file2. By default, the mode and owner of file2 are preserved if it already existed; oth- 
erwise the mode of the source file modified by the current umask(2) is used. The —p option causes cp to 
attempt to preserve (duplicate) in its copies the modification times and modes of the source files, ignoring 


the present umask. 

In the second form, one or more files are copied into the directory with their original file-names. 

Cp refuses to copy a file onto itself. 

-i Tells cp to prompt the user with the name of the file whenever the copy will cause an old file to be 
overwritten. An answer of ’y’ will cause cp to continue. Any other answer will prevent it from 
overwriting the file. 

-r If any of the source files are directories, cp copies each subtree rooted at that name; in this case 
the destination must be a directory. 

SEE ALSO 


cat(1), mv(1), rep(1C) 
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NAME 
crypt — encode/decode 
SYNOPSIS 
crypt [ password ] 
DESCRIPTION 
Crypt reads from the standard input and writes on the standard output. The password is a key that selects 
a particular transformation. If no password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts with the same key: 
crypt key <clear >cypher 
crypt key <cypher | pr 
will print the clear. 
Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 
The security of encrypted files depends on three factors: the fundamental method must be hard to solve; 
direct search of the key space must be infeasible; ‘sneak paths’ by which keys or cleartext can become visi- 
ble must be minimized. 

_ Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 256- 
element rotor. Methods of attack on such machines are known, but not widely; moreover the amount of 
work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed to be expen- 
sive, i.e. to take a substantial fraction of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a substantial fraction of five minutes 
of machine time. 
Since the key is an argument to the crypt comniand, it is potentially visible to users executing ps(1) or a 
derivative. To minimize this possibility, crypt takes care to destroy any record of the key immediately 
upon entry. No doubt the choice of keys and key security are the most vulnerable aspect of crypt. 

FILES 
/dev/tty for typed key 

SEE ALSO 
ed(1), makekey(8) 

BUGS 


There is no warranty of merchantability nor any warranty of fitness for a particular purpose nor any other © 
warranty, either express or implied, as to the accuracy of the enclosed materials or as to their suitability for 
any particular purpose. Accordingly, Bell Telephone Laboratories assumes no responsibility for their use 
by the recipient. Further, Bell Laboratories assumes no obligation to furnish any assistance of any kind 
whatsoever, or to furnish any additional information or documentation. 
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NAME 

csh — a shell (command interpreter) with C-like syntax 
SYNOPSIS 

esh [ —cefinstvVxX ] [ arg... ] 
DESCRIPTION 


Csh is a first implementation of a command language interpreter incorporating a history mechanism (see 
History Substitutions), job control facilities (see Jobs), interactive filename and user name completion 
(see Filename Completion), and a C-like syntax. So as to be able to use its job control facilities, users of 
csh must (and automatically) use the new tty driver fully described in tty(4). This new tty driver allows 
generation of interrupt characters from the keyboard to tell jobs to stop. See stty(1) for details on setting 
options in the new tty driver. 


An instance of csh begins by executing commands from the file ‘.cshrc’ in the home directory of the 
invoker. If this is a login shell then it also executes commands from the file ‘.login’ there. It is typical for 
users on crt’s to put the command ‘‘stty crt’’ in their .ogin file, and to also invoke tset(1) there. 


In the normal case, the shell will then begin reading commands from the terminal, prompting with ‘% ’. 
Processing of arguments and the use of the shell to process files containing command scripts will be 
described later. 


The shell then repeatedly performs the following actions: a line of command input is read and broken into 
words. This sequence of words is placed on the command history list and then parsed. Finally each com- 
mand in the current line is executed. 


When a login shell terminates it executes commands from the file ‘logout’ in the users home directory. 
Lexical structure 


The shell splits input lines into words at blanks and tabs with the following exceptions. The characters ‘&’ 
‘! ‘3? “<? ‘>’ °C‘) form separate words. If doubled in ‘&&’, ‘| |’, ‘<<’ or ‘>>’ these pairs form single 
words. These parser metacharacters may be made part of other words, or prevented their special meaning, 
by preceding them with ‘\’. A newline preceded by a ‘\’ is equivalent to a blank. 


In addition strings enclosed in matched pairs of quotations, ‘”’, ‘*’ or ‘"’, form parts of a word; metacharac- 
ters in these strings, including blanks and tabs, do not form separate words. These quotations have seman- 
tics to be described subsequently. Within pairs of ‘’’ or ‘"’ characters a newline preceded by a ‘\’ gives a 
true newline character. 

When the shell’s input is not a terminal, the character ‘#’ introduces a comment which continues to the end 
of the input line. It is prevented this special meaning when preceded by ‘\’ and in quotations using “’, ‘”’, 
and ‘"’, 


Commands 


A simple command is a sequence of words, the first of which specifies the command to be executed. A 
simple command or a sequence of simple commands separated by ‘|’ characters forms a pipeline. The out- 
put of each command in a pipeline is connected to the input of the next. Sequences of pipelines may be 
separated by ‘;’, and are then executed sequentially. A sequence of pipelines may be executed without 
immediately waiting for it to terminate by following it with an ‘&’. 


Any of the above may be placed in ‘(’ ‘)’ to form a simple command (which may be a component of a 
Pipeline, etc.) It is also possible to separate pipelines with ‘| |’ or ‘&&’ indicating, as in the C language, 
that the second is to be executed only if the first fails or succeeds respectively. (See Expressions.) 
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Jobs . 
The shell associates a job with each pipeline. It keeps a table of current jobs, printed by the jobs command, 
and assigns them small integer numbers. When a job is started asynchronously with ‘&’, the shell prints a 
line which looks like: . 

{1] 1234 


indicating that the job which was started asynchronously was job number 1 and had one (top-level) pro- 
cess, whose process id was 1234. 


_ If you are running a job and wish to do something else you may hit the key “Z (coatrol-Z) which sends a 
STOP signal to the current job. The shell will then normally indicate that the job has been ‘Stopped’, and 
print another prompt. You can then manipulate the state of this job, putting it in the background with the 
bg command, or run some other commands and then eventually bring the job back into the foreground with 
the foreground command fg. A “Z takes effect immediately and is like an interrupt in that pending output 
and unread input are discarded when it is typed. There is another special key “Y which does not generate a 
STOP signal until a program attempts to read(2) it. This can usefully be typed ahead when you have 
prepared some commands for a job which you wish to stop after it has read them. 


A job being run in the background will stop if it tries to read from the terminal. Background jobs are nor- 
mally allowed to produce output, but this can be disabled by giving the command ‘‘stty tostop’’. If you set 
this tty option, then background jobs will stop when they try to produce output like they do when they try 
to read input. 


There are several ways to refer to jobs in the shell. The character ‘%’ introduces a job name. If you wish 
to refer to job number 1, you can name it as ‘%1’. Just naming a job brings it to the foreground; thus ‘%1’ 
is a synonym for ‘fg %1’, bringing job 1 back into the foreground. Similarly saying ‘%1 &’ resumes job 1 
in the background. Jobs can also be named by prefixes of the string typed in to start them, if these prefixes 
are unambiguous, thus ‘%ex’ would normally restart a suspended ex(1) job, if there were only one 
suspended job whose name began with the string ‘ex’. It is also possible to say ‘%?string’ which specifies 
a job whose text contains string, if there is only one such job. 


The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the current job 
is marked with a ‘+’ and the previous job with a ‘—’. The abbreviation ‘%+’ refers to the current job and 
*%—’ refers to the previous job. For close analogy with the syntax of the history mechanism (described 
below), ‘%%’ is also a synonym for the current job. 


Status reporting 


This shell learns immediately whenever a process changes state. It normally informs you whenever a job 
becomes blocked so that no further progress is possible, but only just before it prints a prompt. This is 
done so that it does not otherwise disturb your work. If, however, you set the shell variable notify, the shell 
will notify you immediately of changes of status in background jobs. There is also a shell command notify 
which marks a single process so that its status changes will be immediately reported. By default notify 
marks the current process; simply say ‘notify’ after starting a background job to mark it. 


When you try to leave the shell while jobs are stopped, you will be warmed that ‘You have stopped jobs.’ 
You may use the jobs command to see what they are. If you do this or immediately try to exit again, the 
shell will not warn you a second time, and the suspended jobs will be terminated. 


Filename Completion 


When the filename completion feature is enabled by setting the shell variable filec (see set), csh will 
interactively complete filenames and user names from unique prefixes, when they are input from the termi- 
nal followed by the escape character (the escape key, or control-[). For example, if the current directory 


looks like 
DSC.OLD bin cmd lib xmpl.c 
DSC.NEW Chaosnet cmtest mail xmpl.o 


bench class dev mbox xmpl.out 
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and the input is 
% vi ch<escape> 
csh will complete the prefix “‘ch’’ to the only matching filename ‘‘chaosnet’’, changing the input line to 
% vi chaosnet 
However, given 
% vi D<escape> 
csh will only expand the input to 
% vi DSC. 
and will sound the terminal bell to indicate that the expansion is incomplete, since there are two filenames 
matching the prefix ‘‘D’’. 
If a partial filename is followed by the end-of-file character (usually contro!-D), then, instead of completing 
the name, csh will list all filenames matching the prefix. For example, the input ' 
% vi D<control-D> 
Causes all files beginning with ‘‘D’’ to be listed: 
DSC.NEW DSC.OLD 
while the input line remains unchanged. 


The same system of escape and end-of-file can also be used to expand partial user names, if the word to be 
completed (or listed) begins with the character ‘‘~’’. For example, typing 

cd “ro<control-D> 
may produce the expansion 

cd “root 
The use of the terminal bell to signal errors or multiple matches can be inhibited by setting the variable 
nobeep. 


Normally, all files in the particular directory are candidates for name completion. Files with certain 
suffixes can be excluded from consideration by setting the variable fignore to the list of suffixes to be 
ignored. Thus, if fignore is set by the command 

% set fignore = (.0 .out) 
then typing 

% vi x<escape> 
would result in the completion to 

% vi xmpl.c 
ignoring the files "xmpl.o” and "xmpl.out". However, if the only completion possible requires not ignoring 
these suffixes, then they are not ignored. In addition, fgnore does not affect the listing of filenames by 
control-D. All files are listed regardless of their suffixes. 


Substitutions 


We now describe the various transformations the shell performs on the input in the order in which they 
occur. 


History substitutions 


History substitutions place words from previous command input as portions of new commands, making it 
easy to repeat commands, repeat arguments of a previous command in the current command, or fix spelling 
mistakes in the previous command with little typing and a high degree of confidence. History substitutions 
begin with the character ‘!’ and may begin anywhere in the input stream (with the proviso that they do not 
nest.) This ‘!’ may be preceded by an ‘\’ to prevent its special meaning; for convenience, a ‘!’ is passed 
unchanged when it is followed by a blank, tab, newline, ‘=’ or ‘(’. (History substitutions also occur when 
an input line begins with ‘T’. This special abbreviation will be described later.) Any input line which con- 
tains history substitution is echoed on the terminal before it is executed as it could have been typed without 
history substitution. 
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Commands input from the terminal which consist of one or more words are saved on the history list. The 
history substitutions reintroduce sequences of words from these saved commands into the input stream. 
The size of which is controlled by the history variable; the previous command is always retained, regard- 
less of its value. Commands are numbered sequentially from 1. | 
For definiteness, consider the following output from the history command: 
9 write michael | 
10 ex write.c 


11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It is not usually necessary to use event numbers, but 
the current event number can be made part of the prompt by placing an ‘? in the prompt string. 


With the current event 13 we can refer to previous events by event number ‘!11’, relatively as in ‘!—2’ 
(referring to the same event), by a prefix of a command word as in ‘!d’ for event 12 or ‘!wri’ for event 9, or 
by a string contained in a word in the command as in ‘!?mic?’ also referring to event 9. These forms, 
without further modification, simply reintroduce the words of the specified events, each separated by a sin- 
gle blank. As a special case ‘!!’ refers to the previous command; thus ‘!!’ alone is essentially a redo. 


To select words from an event we can follow the event specification by a ‘:’ and a designator for the 
desired words. The words of an input line are numbered from 0, the first (usually command) word being 0, 
the second word (first argument) being 1, etc. The basic word designators are: 


first (command) word 

n’th argument 

tT first argument, i.e. ‘1’ 

$- last argument 

% word matched by (immediately preceding) ?s? search 
x-y range of words 

—~y abbreviates ‘O—y’ 


so 


* abbreviates ‘T-$’, or nothing if only 1 word in event 
x* abbreviates ‘x —$’ 
x- like ‘x *’ but omitting word ‘$’ 


The ‘:’ separating the event specification from the word designator can be omitted if the argument selector 
begins with a ‘T’, ‘$’, ‘*’ ‘—’ or ‘%’. After the optional word designator can be placed a sequence of 
modifiers, each preceded by a ‘:’. The following modifiers are defined: 


h Remove a trailing pathname component, leaving the head. 
r Remove a trailing ‘.xxx’ component, leaving the root name. 
e Remove all but the extension ‘.xxx’ part. 

s/lir/ Substitute / for r 


t Remove all leading pathname components, leaving the tail. 
& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. ‘g&’. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 
x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a ‘g’ the modification is applied only to the first modifiable word. With substitutions, it 
is an error for no word to be applicable. 


The left hand side of substitutions are not regular expressions in the sense of the editors, but rather strings. 
Any character may be used as the delimiter in place of ‘/’; a ‘\’ quotes the delimiter into the / and r strings. 
The character ‘&’ in the right hand side is replaced by the text from the left. A ‘\’ quotes ‘&’ also. A null / 
uses the previous string either from a / or from a contextual scan string s in ‘!?s?’. The trailing delimiter in 
the substitution may be omitted if a newline follows immediately as may the trailing ‘?’ in a contextual 
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scan. 


A history reference may be given without an event specification, e.g. ‘!$’. In this case the reference is to 
the previous command unless a previous history reference occurred on the same line in which case this 
form repeats the previous reference. Thus ‘!?foo?T !$’ gives the first and last arguments from the com- 
mand matching ‘?f00?’. 
A special abbreviation of a history reference occurs when the first non-blank character of an input line is a 
‘T’. This is equivalent to ‘!:sT’ providing a convenient shorthand for substitutions on the text of the previ- 
ous line. Thus ‘TIbTlib’ fixes the spelling of ‘lib’ in the previous command. Finally, a history substitution 
may be surrounded with ‘{’ and ‘}’ if necessary to insulate it from the characters which follow. Thus, after 
‘Is —Id “paul’ we might do ‘!{1}a’ to do ‘Is —id “paula’, while ‘!la’ would look for a command starting ‘la’. 


Quotations with ° and " 


The quotation of strings by ‘’’ and ‘"’ can be used to prevent all or some of the remaining substitutions. 
Strings enclosed in ‘’’ are prevented any further interpretation. Strings enclosed in “"’ may be expanded as 
described below. 


In both cases the resulting text becomes (all or part of) a single word; only in one special case (see Com- 
mand Substitition below) does a ‘"’ quoted string yield parts of more than one word; ‘”’ quoted strings 
never do. 

Alias substitution 

The shell maintains a list of aliases which can be established, displayed and modified by the alias and 
unalias commands. After a command line is scanned, it is parsed into distinct commands and the first 
word of each command, left-to-right, is checked to see if it has an alias. If it does, then the text which is 
the alias for that command is reread with the history mechanism available as though that command were 
the previous input line. The resulting words replace the command and argument list. If no reference is 
made to the history list, then the argument list is left unchanged. 


Thus if the alias for ‘ls’ is ‘ls -1’ the command ‘ls /usr’ would map to ‘ls —1 /usr’, the argument list here 
being undisturbed. Similarly if the alias for ‘lookup’ was ‘grep !T /etc/passwd’ then ‘lookup bill’ would 
map to ‘grep bill /etc/passwd’. 


If an alias is found, the word transformation of the input text is performed and the aliasing process begins 
again on the reformed input line. Looping is prevented if the first word of the new text is the same as the 
old by flagging it to prevent further aliasing. Other loops are detected and cause an error. 


Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can ‘alias print ‘pr \!* | 
Ipr”’ to make a command which pr’s its arguments to the line printer. 


Variable substitution 


The shell maintains a set of variables, each of which has as value a list of zero or more words. Some of 
these variables are set by the shell or referred to by it. For instance, the argv variable is an image of the 
shell’s argument list, and words of this variable’s value are referred to in special ways. 


The values of variables may be displayed and changed by using the set and unset commands. Of the vari- 
ables referred to by the shell a number are toggles; the shell does not care what their value is, only whether 
they are set or not. For instance, the verbose variable is a toggle which causes command input to be 
echoed. The setting of this variable results from the —v command line option. 


Other operations treat variables numerically. The ‘@’ command permits numeric calculations to be per- 
formed and the result assigned to a variable. Variable values are, however, always represented as (zero or 
more) strings. For the purposes of numeric operations, the null string is considered to be zero, and the 
second and subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before each command is executed, variable substitution is 
performed keyed by ‘$’ characters. This expansion can be prevented by preceding the ‘$’ with a ‘\’ except 
within ‘"’s where it always occurs, and within ‘’’s where it never occurs. Strings quoted by “’ are 
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interpreted later (see Command substitution below) so ‘$’ substitution does not occur there until later, if at 
all. A ‘$’ is passed unchanged if followed by a blank, tab, or end-of-line. 


Input/output redirections are recognized before variable expansion, and are variable expanded separately. 
Otherwise, the command name and entire argument list are expanded together. It is thus possible for the 
first (Command) ee ee er ere es ree en 
mand name, and the rest of which become arguments. 


Unless enclosed in ‘"’ or given the ‘:q’ modifier the results of variable substitution may eventually be com- 
mand and filename substituted. Within ‘"’, a variable whose value consists of multiple words expands to a 
(portion of) a single word, with the words of the variables value separated by blanks. When the ‘:q’ 
modifier is applied to a substitution the variable will expand to multiple words with each word separated by 
a blank and quoted to prevent later command or filename substitution. 
The following metasequences are provided for introducing variable values into the shell input. Eicepe as 
noted, it is an error to reference a variable which is not set. 
$name 
${name} 
Are replaced by the words of the value of variable name, each separated by a blank. Braces insulate 
name from following characters which would otherwise be part of it. Shell variables have names 
consisting of up to 20 letters and digits starting with a letter. The underscore character is considered 
a letter. . 
If name is not a shell variable, but is set in the environment, then that value is returned (but : 
modifiers and the other forms given below are not available in this case). 


$name[selector] 

${name[selector]} 
May be used to select only some of the words from the value of name. The selector is subjected to 
‘$’ substitution and may consist of a single number or two numbers separated by a ‘—’. The first 
word of a variables value is numbered ‘1’. If the first number of a range is omitted it defaults to ‘1’. 
If the last member of a range is omitted it defaults to ‘$#name’. The selector ‘*’ selects all words. It 
is not an Bette for mrange:to Pe eanpy tf the second saguanent 5 omits or mn Tange: 

$#name 

${#name} 
Gives the number of words in the variable. This is useful for later use in a ‘[selector]’. 


$0 
Substitutes the name of the file from which command input is being read. An error occurs if the 
name is not known. 
$number 
${number} 
Equivalent to ‘$argv[number]’. 
$+ 
Equivalent to ‘$argv[*]’. 
The modifiers * sh’, ‘:t’, ‘sr’, ‘:q’ and ‘:x’ sii ei plied is tas aaledianona ‘shove hay igh’, ‘:gt’ and 
‘ser’. If braces ‘{’ ; appear in the command form then the modifiers must appear within the braces. The 
current implementation allows only one ‘:’ modifier on each ‘$’ expansion. 


The following substitutions may not be modified with ‘:’ modifiers. 


$?name 
${?name} 
Substitutes the string ‘1’ if name is set, ‘0’ if it is not. 
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$70 

Substitutes ‘1’ if the current input filename is known, ‘0’ if it is not. 
$$ 

Substitute the (decimal) process number of the (parent) shell. 
$< 


Substitutes a line from the standard input, with no further interpretation thereafter. It can be used to 
read from the keyboard in a shell script. 


Command and filename substitution 


The remaining substitutions, command and filename substitution, are applied selectively to the arguments 
of builtin commands. This means that portions of expressions which are not evaluated are not subjected to 
these expansions. For commands which are not internal to the shell, the command name is substituted 
separately from the argument list. This occurs very late, after input-output redirection is performed, and in 
a child of the main shell. 


Command substitution 


Command substitution is indicated by a command enclosed in “’. The output from such a command is 
normally broken into separate words at blanks, tabs and newlines, with null words being discarded, this text 
then replacing the original string. Within ‘"’s, only newlines force new words; blanks and tabs are 
preserved. 


In any case, the single final newline does not force a new word. Note that it is thus possible for a command 
substitution to yield only part of a word, even if the command outputs a complete line. 


Filename substitution 


If a word contains any of the characters ‘*’, ‘?’, ‘[’ or ‘{’ or begins with the character ‘~’, then that word is 
a candidate for filename substitution, also known as ‘globbing’. This word is then regarded as a pattern, 
and replaced with an alphabetically sorted list of filenames which match the pattern. In a list of words 
specifying filename substitution it is an error for no pattern to match an existing filename, but it is not 
required for each pattern to match. Only the metacharacters ‘*’, ‘?’ and ‘[’ imply pattern matching, the 
characters ‘~’ and ‘{’ being more akin to abbreviations. 


In matching filenames, the character ‘.’ at the beginning of a filename or immediately following a ‘/’, as 
well as the character ‘/’ must be matched explicitly. The character ‘*’ matches any string of characters, 
including the null string. The character ‘?’ matches any single character. The sequence ‘[...]’ matches any 
one of the characters enclosed. Within ‘[...]’, a pair of characters separated by ‘“—’ matches any character 
lexically between the two. 


The character ‘~’ at the beginning of a filename is used to refer to home directories. Standing alone, i.e. “~’ 
it expands to the invokers home directory as reflected in the value of the variable home. When followed by 
a name consisting of letters, digits and ‘—’ characters the shell searches for a user with that name and sub- 
stitutes their home directory; thus ‘ken’ might expand to ‘/usr/ken’ and “ken/chmach’ to 
‘/ust/ken/chmach’. If the character ‘~’ is followed by a character other than a letter or ‘/’ or appears not at 
the beginning of a word, it is left undisturbed. 


The metanotation ‘a{b,c,d}e’ is a shorthand for ‘abe ace ade’. Left to right order is preserved, with results 
of matches being sorted separately at a low level to preserve this order. This construct may be nested. 
Thus ““source/s1/{oldls,ls}.c’ expands to ‘/usr/source/s1/oldls.c /ust/source/si/ls.c’ whether or not these 
files exist without any chance of error if the home directory for ‘source’ is ‘/usr/source’. Similarly 
‘,./{memo,*box}’ might expand to ‘./memo ../box ./mbox’. (Note that ‘memo’ was not sorted with the 
results of matching ‘*box’.) As a special case ‘{’, ‘}’ and ‘{}’ are passed undisturbed. 
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Input/output 
The standard input and standard output of a command may be redirected with the following syntax: 


< name 
Open le name (which sin variable, command and flename expanded) athe sander input 


<< word 

Read the shell input up to a line which is identical to word. Word is not subjected to variable, 
filename or command substitution, and each input line is compared to word before any substitutions 
are done on this input line. Unless a quoting ‘\’, ‘“’, ‘” or “’ appears in word variable and command 
substitution is performed on the intervening lines, allowing ‘\’ to quote ‘$’, ‘\’ and “’. Commands 
which are substituted have all blanks, tabs, and newlines preserved, except for the final newline 
which is dropped. The resultant text is placed in an anonymous temporary file which is given to the 
command as standard input. 


> name 

>! name 

>& name 

>&! name 
The file name is used as standard output. If the file does not exist then it is created; if the file exists, 
its is truncated, its previous contents being lost. 


If the variable noclobber is set, then the file must not exist or be a character special file (e.g. a termi- 
nal or ‘/dev/null’) or an error results. This helps prevent accidental destruction of files. In this case 
the ‘!? forms can be used and suppress this check. 


The forms involving ‘&’ route the diagnostic output into the specified file as well as the standard out- 
put. Name is expanded in the same way as ‘<’ input filenames are. 


>> name 
>>& name 
>>! name 
>>&! name 
Uses file name as standard output like ‘>’ but places output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not to exist unless one of the ‘!’ forms is given. Other- 
wise similar to ‘>’. 
A command receives the environment in which the shell was invoked as modified by the input-output 
parameters and the presence of the command in a pipeline. Thus, unlike some previous shells, commands 
run from a file of shell commands have no access to the text of the commands by default; rather they 
receive the original standard input of the shell. The ‘<<’ mechanism should be used to present inline data. 
This permits shell command scripts to function as components of pipelines and allows the shell to block 
read its input. Note that the default standard input for a command run detached is not modified to be the 
empty file ‘/dev/null’; rather the standard input remains as the original standard input of the shell. If this is 
a terminal and if the process attempts to read from the terminal, then the process will block and the user 
will be notified (see Jobs above). 


Diagnostic output may be directed through a pipe with the standard output. Simply use the form ‘| &’ 
rather than just ‘|’. 


Expressions 


A number of the builtin commands (to be described subsequently) take expressions, in which the operators 
are similar to those of C, with the same precedence. These expressions appear in the @, exit, if, and while 
commands. The following operators are available: 


[| && | T & ow le w ce oe ce > ce o> t+ -— */%HI7() 
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Here the precedence increases to the right, ‘==’ ‘!=’ ‘=’ and ‘!”’, ‘<=’ ‘>=’ ‘<’ and ‘>’, ‘<<’ and ‘>>’, ‘+’ 
and ‘—’, ‘*’ ‘/’ and ‘%’ being, in groups, at the same level. The ‘==’ ‘!=’ ‘=”’ and ‘!”’ operators compare 
their arguments as strings; all others operate on numbers. The operators ‘="’ and ‘!”’ are like ‘!=’ and ‘==’ 
except that the right hand side is a pattern (containing, e.g. ‘*’s, ‘?’s and instances of ‘[...]’) against which 
the left hand operand is matched. This reduces the need for use of the switch statement in shell scripts 
when all that is really needed is pattern matching. 


Strings which begin with ‘0’ are considered octal numbers. Null or missing arguments are considered ‘0’. 
The result of all expressions are strings, which represent decimal numbers. It is important to note that no 
two components of an expression can appear in the same word; except when adjacent to components of 
expressions which are syntactically significant to the parser (‘&’ ‘|’ ‘<’ ‘>’ ‘(’ ‘)’) they should be sur- 
rounded by spaces. 


Also available in expressions as primitive operands are command executions enclosed in ‘{’ and ‘}’ and 
file enquiries of the form ‘~1 name’ where / is one of: 


read access 
write access 
execute access 
existence 
ownership 
zero size 

plain file 
directory 

The specified name is command and filename expanded and then tested to see if it has the specified rela- 
tionship to the real user. If the file does not exist or is inaccessible then all enquiries return false, i.e. ‘0’. 
Command executions succeed, returning true, i.e. ‘1’, if the command exits with status 0, otherwise they 
fail, returning false, i.e. ‘0’. If more detailed status information is required then the command should be 
executed outside of an expression and the variable status examined. 


Control flow 


The shell contains a number of commands which can be used to regulate the flow of control in command 
files (shell scripts) and (in limited but useful ways) from terminal input. These commands all operate by 
forcing the shell to reread or skip in its input and, due to the implementation, restrict the placement of some 
of the commands. 


The foreach, switch, and while statements, as well as the if—then—else form of the if statement require that 
the major keywords appear in a single simple command on an input line as shown below. 


If the shell’s input is not seekable, the shell buffers up input whenever a loop is being read and performs 
seeks in this internal buffer to accomplish the rereading implied by the loop. (To the extent that this 
allows, backward goto’s will succeed on non-seekable inputs.) 


Builtin commands 


Builtin commands are executed within the shell. If a builtin command occurs as any component of a pipe- 

line except the last then it is executed in a subshell. 

alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form prints the alias for name. The final form assigns 
the specified wordlist as the alias of name; wordlist is command and filename substituted. Name is 
not allowed to be alias or unalias. 


! 


Aa "NO Ox = 


alloc 
Shows the amount of dynamic memory acquired, broken down into used and free memory. With an 
argument shows the number of free and used blocks in each size category. The categories start at 
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size 8 and double at each step. This command’s output may vary across system types, since systems 
other than the VAX may use a different memory allocator. 


bg 

bg &job ... 
. Puts the current or specified jobs into the background, continuing them if they were ‘stopped. 

break 
Causes execution to resume after the tad of the nearest enclosing foreach or while. The remaining 
commands on the current line are executed. Multi-level breaks are thus possible by writing them all 
on one line. . 

breaksw 
Causes a break from a switch, resuming after the endsw. 

case label: 
A label in a switch statement as discussed below. 

ed 

cd name 

chdir 

chdir name 
Change the shell’s working directory to directory name. If no argument is given then change to the 
home directory of the user. 
If name is not found as a subdirectory of the current directory (and does not begin with ‘/’, ‘/’ or 
*./’), then each component of the variable cdpath is checked to see if it has a subdirectory name. 
Finally, if all else fails but name is a shell variable whose value begins with ‘/’, then this is tried to 
see if it is a directory. . 

continue 


Continue execution of the nearest enclosing while or foreach. The rest of the commands on the 
current line are executed. 


default: 
Labels the default case in a switch statement. The default should come after all case labels. 

dirs 
Prints the directory stack; the top of the stack is at the left, the first aceey in the stack being the 
current directory. 


echo wordlist 

echo —n wordlist 
The specified words are written to the shells standard output, separated by spaces, and terminated 
with a newline unless the —n option is specified. 


else 
end 
endif 
endsw 
See the description of the foreach, if, switch, and while statements below. 


eval arg ... 
(As in sh(1).) The arguments are read as input to the shell and the resulting command(s) executed in 
the context of the current shell. This is usually used to execute commands generated as the result of 
command or variable substitution, since parsing occurs before these substitutions. See tset(1) for an 
example of using eval. 


exec command 
The specified command is executed in as of the current shell. 
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exit 

exit(expr) 
The shell exits either with the value of the status variable (first form) or with the value of the 
specified expr (second form). 

fg 

fg %job ... 
Brings the current or specified jobs into the foreground, continuing them if they were stopped. 


foreach name (wordlist) 
end 
The variable name is successively set to each member of wordlist and the sequence of commands 
between this command and the matching end are executed. (Both foreach and end must appear alone 
on separate lines.) 


The builtin command continue may be used to continue the loop prematurely and the builtin com- 
mand break to terminate it prematurely. When this command is read from the terminal, the loop is 
read up once prompting with ‘?’ before any statements in the loop are executed. If you make a mis- 
take typing in a loop at the terminal you can rub it out. 


glob wordlist 
Like echo but no ‘\’ escapes are recognized and words are delimited by null characters in the output. 
Useful for programs which wish to use the shell to filename expand a list of words. 


goto word 
The specified word is filename and command expanded to yield a string of the form ‘label’. The 
shell rewinds its input as much as possible and searches for a line of the form ‘label:’ possibly pre- 
ceded by blanks or tabs. Execution continues after the specified line. 


hashstat 
Print a statistics line indicating how effective the internal hash table has been at locating commands 
(and avoiding exec’s). An exec is attempted for each component of the path where the hash function 
indicates a possible hit, and in each component which does not begin with a ‘/’. 

history . 

history n 

history —r n 

history —h n 
Displays the history event list; if n is given only the m most recent events are printed. The —r option 
reverses the order of printout to be most recent first rather than oldest first. The —h option causes the 
history list to be printed without leading numbers. This is used to produce files suitable for sourceing 
using the —h option to source. 


if (expr) command 
If the specified expression evaluates true, then the single command with arguments is executed. 
Variable substitution on command happens early, at the same time it does for the rest of the if com- 
mand. Command must be a simple command, not a pipeline, a command list, or a parenthesized 
command list. Input/output redirection occurs even if expr is false, when command is not executed 
(this is a bug). 


if (expr) then 
else if (expr2) then 


else 
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endif 
If the specified expr is true then the commands to the first else are executed; otherwise if expr2 is 
true then the commands to the second else are executed, etc. Any number of else-if pairs are possi- 
ble; only one endif is needed. The else part is likewise optional. (The words else and endif must 
appear at the beginning of input lines; the if must appear alone on its input line or after an else.) 


jobs 

jobs -1 | 
Lists the active jobs; given the —1 options lists process id’s in addition to the normal information. 

kill %job 

kill —sig %job ... 

kill pid 

kill —sig pid ... 

kill —1 
Sends either the TERM (terminate) signal or the specified signal to the specified jobs or processes. 
Signals are either given by number or by names (as given in /usr/include/signal.h, stripped of the 
prefix ‘‘SIG’’). The signal names are listed by ‘‘kill -I’’. There is no default, saying just ‘kill’ does 
not send a signal to the current job. If the signal being sent is TERM (terminate) or HUP (hangup), 
then the job or process will be sent a CONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum-use 

limit —h 


limit —h resource 
limit —h resource maximum-use 
Limits the consumption by the current process and each process it creates to not individually exceed 
maximum-use on the specified resource. If no maximum-use is given, then the current limit is 
printed; if no resource is given, then all limitations are given. If the —h flag is given, the hard limits 
are used instead of the current limits. The hard limits impose a ceiling on the values of the current 
limits. Only the super-user may raise the hard limits, but a user may lower or raise the current limits 
within the legal range. 
Resources controllable currently include cputime (the maximum number of cpu-seconds to be used 
by each process), filesize (the largest single file which can be created), datasize (the maximum 
growth of the data+stack region via sbrk(2) beyond the end of the program text), stacksize (the max- 
imum size of the automatically-extended stack region), and coredumpsize (the size of the largest core 
dump that will be created). 
The maximum-use may be given as a (floating point or integer) number followed by a scale factor. 
For all limits other than cputime the default scale is ‘k’ or ‘kilobytes’ (1024 bytes); a scale factor of 
‘m’ or ‘megabytes’ may also be used. For cputime the default scaling is ‘seconds’, while ‘m’ for 
minutes or ‘h’ for hours, or a time of the form ‘mm:ss’ giving minutes and seconds may be used. 
For both resource names and scale factors, unambiguous prefixes of the names suffice. 
login . 
Terminate a login shell, replacing it with an instance of /bin/login. This is one way to log off, 
included for compatibility with sh(1). 
logout 
Terminate a login shell. Especially useful if ignorecef is set. 


nice 
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nice +number 

nice command 

nice +number command 
The first form sets the scheduling priority for this shell to 4. The second form sets the priority to the 
given number. The final two forms run command at priority 4 and number respectively. The greater 
the number, the less cpu the process will get. The super-user may specify negative priority by using 
‘nice —number ...’. Command is always executed in a sub-shell, and the restrictions placed on com- 
mands in simple if statements apply. 


nohup 

nohup command 
The first form can be used in shell scripts to cause hangups to be ignored for the remainder of the 
script. The second form causes the specified command to be run with hangups ignored. All 
processes detached with ‘&’ are effectively nohup’ed. 


notify 

notify %job ... 
Causes the shell to notify the user asynchronously when the status of the current or specified jobs 
changes; normally notification is presented before a prompt. This is automatic if the shell variable 
notify is set. 

onintr 

onintr — 

onintr label 
Control the action of the shell on interrupts. The first form restores the default action of the shell on 
interrupts which is to terminate shell scripts or to return to the terminal command input level. The 
second form ‘onintr —’ causes all interrupts to be ignored. The final form causes the shell to execute 
a ‘goto label’ when an interrupt is received or a child process terminates because it was interrupted. 


In any case, if the shell is running detached and interrupts are being ignored, all forms of onintr have 
no meaning and interrupts continue to be ignored by the shell and all invoked commands. 


popd 

popd +n 
Pops the directory stack, returning to the new top directory. With an argument ‘+’ discards the 7 th 
entry in the stack. The elements of the directory stack are numbered from 0 starting at the top. 


pushd 

pushd name 

pushd +n 
With no arguments, pushd exchanges the top two elements of the directory stack. Given a name 
argument, pushd changes to the new directory (ala cd) and pushes the old current working directory 
(as in csw) onto the directory stack. With a numeric argument, rotates the n th argument of the direc- 
tory stack around to be the top element and changes to it. The members of the directory stack are 
numbered from the top starting at 0. 


rehash 
Causes the internal hash table of the contents of the directories in the path variable to be recomputed. 
This is needed if new commands are added to directories in the path while you are logged in. This 
should only be necessary if you add commands to one of your own directories, or if a systems pro- 
grammer changes the contents of one of the system directories. 


repeat count command 
The specified command which is subject to the same restrictions as the command in the one line if 
statement above, is executed count times. I/O redirections occur exactly once, even if count is 0. 
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set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 
The first form of the command ‘isis the value of all shell variables. Variables which have other 
than a single word as value print as a parenthesized word list. The second form sets name to the null 
string. The third form sets name to the single word. The fourth form sets the index’ th component of 
name to word; this component must already exist. The final form sets name to the list of words in 
wordlist. In all cases the value is command and filename expanded. 
These arguments may be repeated to set multiple values in a single set command. Note however, 
that variable expansion happens for all arguments before any setting occurs. 

setenv . 

setenv name value 

setenv name 
The first form lists all current environment variables. The last form sets the value of environment 
variable name to be value, a single string. The second form sets name to an empty string. The most 
commonly used environment variable USER, TERM, and PATH are automatically imported to and 
exported from the csh variables user, term, and path; there is no need to use setenv for these. 

shift — 

shift variable 
The members of argv are shifted to the left, discarding argv/1]. It is an error for argv not to be set or 
to have less than one word as value. The second form performs the same function on the specified 
variable. 

source name 


source —h name 
The shell reads commands from name. Source commands may be nested; if they are nested too dee- 
ply the shell may run out of file descriptors. An error in a source at any level terminates all nested 
source commands. Normally input during source commands is not placed on the history list; the —h 
option causes the commands to be placed in the history list without being executed. 


stop 

stop %job ... 
Stops the current or specified job which is executing in the background. 

suspend 
Causes the shell to stop in its tracks, much as if it had been sent a stop signal with “Z. This is most 
often used to stop shells started by su(1). 

switch (string) 

case str1: 


breaksw 
default: 
breaksw 
endsw | 
Each case label is successively matched, against the specified string which is first command and 
filename expanded. The file metacharacters ‘*’, ‘?’ and ‘[...]’ may be used in the case labels, which 
are variable expanded. If none of the labels match before a ‘default’ label is found, then the execu- 


tion begins after the default label. Each case label and the default label must appear at the beginning 
of a line. The command breaksw causes execution to continue after the endsw. Otherwise control 
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may fall through case labels and default labels as in C. If no label matches and there is no default, 
execution continues after the endsw. 

time 

time command 
With no argument, a summary of time used by this shell and its children is printed. If arguments are 
given the specified simple command is timed and a time summary as described under the time vari- 
able is printed. If necessary, an extra shell is created to print the time statistic when the command 
completes. 


umask 

umask value 
The file creation mask is displayed (first form) or set to the specified value (second form). The mask 
is given in octal. Common values for the mask are 002 giving all access to the group and read and 
execute access to others or 022 giving all access except no write access for users in the group or oth- 
ers. 

unalias pattern 
All aliases whose names match the specified pattern are discarded. Thus all aliases are removed by 
‘unalias *’. It is not an error for nothing to be unaliased. 


unhash 
Use of the internal hash table to speed location of executed programs is disabled. 

unlimit 

unlimit resource 

ublimit —b 

unlimit —h resource 
Removes the limitation on resource. If no resource is specified, then all resource limitations are 
removed. If —h is given, the corresponding hard limits are removed. Only the super-user may do 
this. 

unset pattern 
All variables whose names match the specified pattern are removed. Thus all variables are removed 
by “unset *’; this has noticeably distasteful side-effects. It is not an error for nothing to be unset. 


unsetenv pattern 
Removes all variables whose name match the specified pattern from the environment. See also the 
setenv command above and printenv(1). 

wait 
All background jobs are waited for. It the shell is interactive, then an interrupt can disrupt the wait, 
at which time the shell prints names and job numbers of all jobs known to be outstanding. 


while (expr) 


end . 
While the specified expression evaluates non-zero, the commands between the while and the match- 
ing end are evaluated. Break and continue may be used to terminate or continue the loop prema- 
turely. (The while and end must appear alone on their input lines.) Prompting occurs here the first 
time through the loop as for the foreach statement if the input is a terminal. 


Brings the specified job into the foreground. 
job & 
Continues the specified job in the background. 
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@ 
@ name = expr 
@ name[index]) = expr 
The first form prints the values of all the shell variables. The second form sets the specified name to 
the value of expr. If the expression contains ‘<’, ‘>’, ‘&’ or ‘|’ then at least this part of the expression 
must be placed within ‘(’ ‘)’. The third form assigns the value of expr to the index’ th argument of 
name. Both name and its index’ th component must already exist. 
The operators ‘*=’, ‘+=’, etc are available as in C. The space separating the name from the assign- 
ment Operator is optional. Spaces are, however, sce in separating components of expr which 
would otherwise be single words. 
Special postfix ‘++’ and ‘-—’ operators increment and decrement name respectively, i.e. ‘@ i++’. 
Pre-defined and environment variables 
The following variables have special meaning to the shell. Of these, argv, cwd, home, path, prompt, shell 
and status are always set by the shell. Except for cwd and status this setting occurs only at initialization; 
these variables will not then be modified unless this is done explicitly by the user. | 
This shell copies the environment variable USER into the variable user, TERM into term, and HOME into 
home, and copies these back into the environment whenever the normal shell variables are reset. The 
environment variable PATH is likewise handled; it is not necessary to worry about its setting other than in 
the file .cshrc as inferior csh processes will import the definition of path from the environment, and re- 


export it if you then change it. 

argv Set to the arguments to the shell, it is from this variable that positional parameters are 
Substituted, i.e. ‘$1’ is replaced by ‘$argv[1)’, etc. 

cdpath Gives a list of alternate directories searched to find subdirectories in chdir commands. 

cwd The full pathname of the current directory. 

echo Set when the —x command line option is given. Causes each command and its argu- 


ments to be echoed just before it is executed. For non-builtin commands all expansions 
occur before echoing. Builtin commands are echoed before command and filename sub- 
Stitution, since these substitutions are then done selectively. 


filec Enable filename completion. 


histchars Can be given a string value to change the characters used in history substitution. The 
first character of its value is used as the history substitution character, replacing the 
default character !. The second character of its value replaces the character T in quick 
substitutions. 


history Can be given a numeric value to control the size of the history list. Any command 
which has been referenced in this many events will not be discarded. Too large values 
of history may run the shell out of memory. The last executed command is always saved 


on the history list. 

home - The home directory of the invoker, initialized from the environment. The filename 
expansion of ‘~’ refers to this variable. 

ignoreeof If set the shell ignores end-of-file from input devices which are terminals. This prevents 
shells from accidentally being killed by control-D’s. 

mail The files where the shell checks for mail. This is done after each command completion 


which will result in a prompt, if a specified interval has elapsed. The shell says ‘You 
have new mail.’ if the file exists with an access time not greater than its modify time. 

If the first word of the value of mail is numeric it specifies a different mail checking 
interval, in seconds, than the default, which is 10 minutes. 
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If multiple mail files are specified, then the shell says ‘New mail in name’ when there is 
mail in the file name. 


As described in the section on Jnput/output, restrictions are placed on output redirection 
to insure that files are not accidentally destroyed, and that ‘>>’ redirections refer to 
existing files. 

If set, filename expansion is inhibited. This is most useful in shell scripts which are not 
dealing with filenames, or after a list of filenames has been obtained and further expan- 
sions are not desirable. 


If set, it is not an error for a filename expansion to not match any existing files; rather the 
primitive pattern is returned. It is still an error for the primitive pattern to be malformed, 
i.e. ‘echo [’ still gives an error. 

If set, the shell notifies asynchronously of job completions. The default is to rather 
present job completions just before printing a prompt. 

Each word of the path variable specifies a directory in which commands are to be sought 
for execution. A null word specifies the current directory. If there is no path variable 
then only full path names will execute. The usual search path is ‘.’, ‘/bin’ and ‘/usr/bin’, 
but this may vary from system to system. For the super-user the default search path is 
‘/etc’, ‘/bin’ and ‘/usr/bin’. A shell which is given neither the —c nor the —t option will 
normally hash the contents of the directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new commands are added to these directories 
while the shell is active, it may be necessary to give the rehash or the commands may 
not be found. 


The string which is printed before each command is read from an interactive terminal 
input. If a ‘!’ appears in the string it will be replaced by the current event number unless 
a preceding ‘\’ is given. Default is ‘% ’, or ‘#’ for the super-user. 

is given a numeric value to control the number of entries of the history list that are saved 
in “/.history when the user logs out. Any command which has been referenced in this 
many events will be saved. During start up the shell sources “/.history into the history 
list enabling history to be saved across logins. Too large values of savehist will slow 
down the shell during start up. 


The file in which the shell resides. This is used in forking shells to interpret files which 
have execute bits set, but which are not executable by the system. (See the description 
of Non-builtin Command Execution below.) Initialized to the (system-dependent) home 
of the shell. 

The status returned by the last command. If it terminated abnormally, then 0200 is 
added to the status. Builtin commands which fail return exit status ‘1’, all other builtin 
commands set status ‘0’. 

Controls automatic timing of commands. If ae then any command which takes more 
than this many cpu seconds will cause a line giving user, system, and real times and a 
utilization percentage which is the ratio of user plus system times to real time to be 
printed when it terminates. . 

Set by the —v command line option, causes the words of each command to be printed 
after history substitution. . 
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Non-builtin command execution 
When a command to be executed is found to not be a builtin command the shell attempts to execute the 
command via execve(2). Each word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a —-c nor a —¢ option, the shell will hash the names in 
these directories into an internal table so that it will only try an exec in a directory if there is a possibility 
that the command resides there. This greatly speeds command location when a large number of directories 
are present in the search path. If this mechanism has been tumed off (via unhash), or if the shell was given 
a—c or —t argument, and in any case for each directory component of path which does not begin with a ae 
_ the shell concatenates with the given command name to form a path name of a file which it then attempts to 
execute. 


Parenthesized commands are always executed in a subshell. Thus ‘(cd ; pwd) ; pwd’ prints the home direc- 
tory; leaving you where you were (printing this after the home directory), while ‘cd ; pwd’ leaves you in 
the home directory. Parenthesized commands are most often used to prevent chdir from affecting the 
current shell. 


If the file has execute permissions but is not an executable binary to the system, then it is assumed to be a 
file containing shell commands and a new shell is spawned to read it. 


If there is an alias for shell then the words of the alias will be prepended to the argument list to form the 
shell command. The first word of the alias should be the full path name of the shell (e.g. ‘$shell’). Note 
that this is a special, late occurring, case of alias substitution, and only allows words to be prepended to the 
argument list without modification. _ 


Argument list processing 
If argument 0 to the shell is ‘—’ then this is a login shell. The flag arguments are interpreted as follows: 


-b = This flag forces a ‘‘break’’ from option processing, causing any further shell arguments to be treated 
as non-option arguments. The remaining arguments will not be interpreted as shell options. This 
may be used to pass options to a shell script without confusion or possible subterfuge. The shell will 
not run a set-user ID script without this option. 


—c Commands are read from the (single) following argument which must be present. Any remaining 
arguments are placed in argv. 


-e The shell exits if any invoked command terminates abnormally or yields a non-zero exit status. 


-~f The shell will start faster, because it will neither search for nor execute commands from the file 
‘.cshrc’ in the invoker’s home directory. 


-i The shell is interactive and prompts for its top-level input, even if it appears to not be a terminal. 
Shells are interactive without this option if their inputs and outputs are terminals. 


-n Commands are parsed, but not executed. This aids in syntactic checking of shell scripts. 
Command input is taken from the standard input. 


—§ 
-t A single line of input is read and executed. A ‘\’ may be used to escape the newline at the end of this 
line and continue onto another line. 


—v Causes the verbose variable to be set, with the effect that command input is echoed after history sub- 
stitution. 

-x Causes the echo variable to be set, so that commands are echoed immediately before execution. 

-V Causes the verbose variable to be set even before ‘.cshrc’ is executed. 

-X Is to-x as —V is to-v. 


After processing of flag arguments, if arguments remain but none of the —c, —i, —s, or —t options was given, 
the first argument is taken as the name of a file of commands to be executed. The shell opens this file, and 
Saves its name for possible resubstitution by ‘$0’. Since many systems use either the standard version 6 or 
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version 7 shells whose shell scripts are not compatible with this shell, the shell will execute such a ‘stan- 
dard’ shell if the first character of a script is not a ‘#’, i.e. if the script does not start with a comment. 
Remaining arguments initialize the variable argv. 


Signal handling 


The shell normally ignores quit signals. Jobs running detached (either by ‘&’ or the bg or %... & com- 
mands) are immune to signals generated from the keyboard, including hangups. Other signals have the 
values which the shell inherited from its parent. The shells handling of interrupts and terminate signals in 
shell scripts can be controlled by onintr. Login shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell’s parent. In no case are interrupts allowed when a login 
shell is reading the file ‘logout’. 


AUTHOR 


William Joy. Job control and directory stack features first implemented by J.E. Kulp of I.LA.S.A, Laxen- 
burg, Austria, with different syntax than that used now. File name completion code written by Ken Greer, 
HP Labs. 


FILES 

“/.cshre Read at beginning of execution by each shell. 

“/Jogin Read by login shell, after ‘.cshrc’ at login. 

“/ logout Read by login shell, at logout. 

/din/sh Standard shell, for shell scripts not starting with a ‘#’. 

/tmp/sh* Temporary file for ‘<<’. 

/etc/passwd Source of home directories for ‘“name’. 
LIMITATIONS 


Words can be no longer than 1024 characters. The system limits argument lists to 10240 characters. The 
number of arguments to a command which involves filename expansion is limited to 1/6’th the number of 
characters allowed in an argument list. Command substitutions may substitute no more characters than are 
allowed in an argument list. To detect looping, the shell restricts the number of alias substitutions on a sin- 
gle line to 20. 


SEE ALSO 


BUGS 


sh(1), access(2), execve(2), fork(2), killpg(2), pipe(2), sigvec(2), umask(2), setrlimit(2), wait(2), tty(4), 
a.out(5), environ(7), ‘An introduction to the C shell’ 


When a command is restarted from a stop, the shell prints the directory it started in if this is different from 
the current directory; this can be misleading (i.e. wrong) as the job may have changed directories inter- 
nally. 


Shell builtin functions are not stoppable/restartable. Command sequences of the form ‘a ; b ; c’ are also not 
handled gracefully when stopping is attempted. If you suspend ‘b’, the shell will then immediately execute 

‘c’. This is especially noticeable if this expansion results srorn en aban. It setae to place the sequence of 
commands in ()’s to force it to a subshell, Le. ‘(a;b;c)’. 


Control over tty output after processes are started is primitive; perhaps this will inspire someone to work on 
a good virtual terminal interface. In a virtual terminal interface much more interesting things could be 
done with output control. 


Alias substitution is most often used to clumsily simulate shell procedures; shell procedures should be pro- » 
vided rather than aliases. 


Commands within loops, prompted for by ‘?’, are not placed in the history list. Control structure should be 
parsed rather than being recognized as built-in commands. This would allow control commands to be 
placed anywhere, to be combined with ‘|’, and to be used with ‘&’ and ‘;’ metasyntax. 
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re should be possible to use the ‘:’ modifiers on the output of command substitutions. All and more than 
e ‘:’ modifier should be allowed on ‘$’ substitutions. 


The way the filec facility is implemented is ugly and expensive. : 
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NAME 


ctags — create a tags file 


SYNOPSIS 


ctags [ options } [ -f tagsfile ] name ... 


DESCRIPTION 


Ctags makes a tags file for ex(1) from the specified C, Pascal, Fortran, YACC, lex, and lisp sources. A 
tags file gives the locations of specified objects (in this case functions and typedefs) in a group of files. 
Each line of the tags file contains the object name, the file in which it is defined, and an address 
specification for the object definition. Functions are searched with a pattern, typedefs with a line number. 
Specifiers are given in separate fields on the line, separated by blanks or tabs. Using the tags file, ex can 
quickly find these objects definitions. 


Normally ctags places the tag descriptions in a file called tags. You can use the -f option to specify a dif- 
ferent filename if you wish. See the description of ctag options below. 


Files whose names end in .c or .h are assumed to be C source files and are searched for C routine and 
macro definitions. Files whose names end in .y are assumed to be YACC source files. Files whose names 
end in .l are assumed to be either lisp files if their first non-blank character is ‘;’, ‘(’, or ‘[’, or lex files oth- 
erwise. Other files are first examined to see if they contain any Pascal or Fortran routine definitions; if not, 
they are processed again looking for C definitions. 


The tag main is treated specially in C programs. The tag formed is created by prepending M to the name of 
the file, with a trailing .c removed, if any, and leading pathname components also removed. This makes 
use Of ctags practical in directories with more than one program. 


OPTIONS 


FILES 


-—a_ Appends to tags file. 
-B Uses backward searching patterns (?...7). 


—f tagsfile | 
Tells ctags to place the tag descriptions in a file called tagsfile intead of the default file called tags. 


-F Uses forward searching patterns (/.../) (default). 
-t Creates tags for typedefs. 


-—u Causes the specified files to be updated in tags, that is, all references to them are deleted, and the new 
values are appended to the file. (Beware: this option is implemented in a way which is rather slow; it 
is usually faster to simply rebuild the tags file.) 

-v Produces an index of the form expected by vgrind(1) on the standard output. This listing contains 
the function name, filename, and page number (assuming 64 line pages). Since the output will be 
sorted into lexicographic order, it may be desired to run the output through sort —f. Sample use: 

ctags —v files | sort -f > index 
vgrind —x index 
—w Suppresses warning diagnostics. 
~-x Causes ctags to produce a list of object names, the line number and file name on which each is 


defined, as well as the text of that line and prints this on the standard output. This is a simple index 
which can be printed out as an off-line readable function index. 


tags output tags file 


SEE ALSO 


ex(1), vi(1) 
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AUTHOR 
Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added Pascal and —x, replacing cxref; C apes 
added by Ed Pelegri-Llopart. 


BUGS 
Recognition of functions, subroutines and procedures for FORTRAN and Pascal is done is a very sim- 
pleminded way. No attempt is made to deal with block structure; if you have two Pascal procedures in dif- 
ferent blocks with the same name you lose. 


The method of deciding whether to look for C or Pascal and FORTRAN functions is a hack. 
Does not know about #ifdefs. 


Should know about Pascal types. Relies on the input being well formed to detect typedefs. Use of -tx 
shows only the last line of typedefs. 
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NAME. 
date — print and set the date 

SYNOPSIS 
date [ —nu ] [—d dst ] [ —t timezone } [ yymmddhhmm [ .ss] ] 

DESCRIPTION 
If no arguments are given, the current date and time are printed. Providing an argument will set the desired 
date; only the superuser can set the date. The -d and -r flags set the kernel’s values for daylight savings 
time and minutes west of GMT. If dst is non-zero, future calls to gettimeofday(2) will return a non-zero 
tz_dsttime. Timezone provides the number of minutes returned by future calls to gettimeofday(2) in 
tz_minuteswest. The -u flag is used to display or set the date in GMT (universal) time. yy represents the 
last two digits of the year; the first mm is the month number; dd is the day number; Ah is the hour number 
(24 hour system); the second mm is the minute number; .ss is optional and represents the seconds. For 
example: 

date 8506131627 

sets the date to June 13 1985, 4:27 PM. The year, month and day may be omitted; the default values will 
be the current ones. The system operates in GMT. Date takes care of the conversion to and from local 
standard and daylight-saving time. 
If timed(8) is running to synchronize the clocks of machines in a local area network, date sets the time 
globally on all those machines unless the —n option is given. 

FILES 
/usr/adm/wtmp file to record time-setting 
/ust/adm/messages file in which date records the name of the user setting the time 

SEE ALSO 
gettimeofday(2), utmp(5), timed(8), 
TSP: The Time Synchronization Protocol for UNIX 4.3BSD, R. Gusella and S. Zatti 

DIAGNOSTICS 
Exit status is 0 on success, 1 on complete failure to set the date, and 2 on successfully setting the local date 
but failing globally. 
Occasionally, when timed synchronizes the time on many hosts, the setting of a new time value may 
require more than a few seconds. On these occasions, date prints: ‘Network time being set’. The message 
‘Communication error with timed’ occurs when the communication between date and timed fails. 

BUGS 


The system attempts to keep the date in a format closely compatible with VMS. VMS, however, uses local 
time (rather than GMT) and does not understand daylight-saving time. Thus, if you use both UNIX and 
VMS, VMS will be running on GMT. 
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NAME 
dbx — debugger 

SYNOPSIS 
dbx [ options } [ objfile [ coredump }] 

DESCRIPTION 
Dbx is a tool for source level debugging and execution of programs under UNIX. The objfile is an object 
file produced by a compiler with the appropriate flag (usually ‘‘—g’’) specified to produce symbol informa- 
tion in the object file. Currently, cc(1), 177(1), pe(1), and the DEC Western Research Laboratory Modula- 
2 compiler, mod(1), produce the appropriate source information. The machine level facilities of dbx can be 
used on any program. 


The object file contains a symbol table that includes the name of the all the source files translated by the 
compiler to create it. These files are available for perusal while using the debugger. 


If a file named ‘‘core’’ exists in the current directory or a coredump file is specified, dbx can be used to 
examine the state of the program when it faulted. 


If the file ‘‘.dbxinit’’ exists in the current directory then the debugger commands in it are executed. Dbx 
also checks for a ‘‘.dbxinit’’ in the user’s home directory if there isn’t one in the current directory. 


Execution and Tracing Commands 


run [args] [< filename] [> filename] 

rerun [args] [< filename] [> filename] é 
Start executing objfile, passing args as command line seyinaente < or > can be used to redirect 
input or output in the usual manner. When rerun is used without any arguments the previous 
argument list is passed to the program; otherwise it is identical to run. If objfile has been written 
since the last time the symbolic information was read in, dbx will read in the new information. 


trace [in procedure/function] [if condition} 

trace source-line-number [if condition] 

trace procedure/function [in procedure/function] [if condition] 

trace expression at source-line-number [if condition] 

trace variable [in procedure/function] [if condition] 
Have tracing information printed when the program is executed. A number is associated with the 
command that is used to turn the tracing off (see the delete command). 


The first argument describes what is to be traced. If it is a source-line-number, then the line is 
printed immediately prior to being executed. Source line numbers in a file other than the current 
one must be preceded by the name of the file in quotes and a colon, e.g. "mumble.p":17. 


If the argument is a procedure or function name then every time it is called, information is printed 
telling what routine called it, from what source line it was called, and what parameters were 
passed to it. In addition, its return is noted, and if it’s a function then the value it is returning is 
also printed. 


If the argument is an expression with an at clause then the value of the expression is printed 
whenever the identified source line is reached. 


If the argument is a variable then the name and value of the variable is printed whenever it 
changes. Execution is substantially slower during this form of tracing. 


If no argument is specified then all source lines are printed before they are executed. Execution is 
substantially slower during this form of tracing. 
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The clause ‘‘in procedure/function’’ restricts tracing information to be printed only while execut- 
ing inside the given procedure or function. 


Condition is a boolean expression and is evaluated prior to printing the tracing information; if it is 
false then the information is not printed. 

stop if condition 

stop at source-line-number [if condition] 

stop in procedure/function [if condition] 

stop variable [if condition) 
Stop execution when the given line is reached, procedure or function called, variable changed, or 
condition true. 


status [> filename] 
Print out the currently active trace and stop commands. 


delete command-number ... 
The traces or stops corresponding to the given numbers are removed. The numbers associated 
with traces and stops are printed by the status command. 


catch number 

catch signal-name 

ignore number 

ignore signal-name 
Start or stop trapping a signal before it is sent to the program. This is useful when a program 
being debugged handles signals such as interrupts. A signal may be specified by number or by a 
name (e.g., SIGINT). Signal names are case insensitive and the ‘‘SIG’’ prefix is optional. By 
default all signals are trapped except SIGCONT, SIGCHILD, SIGALRM and SIGKILL. 


cont integer 

cont signal-name 
Continue execution from where it stopped. If a signal is specified, the process continues as though 
it received the signal. Otherwise, the process is continued as though it had not been stopped. 


Execution cannot be continued if the process has ‘‘finished’’, that is, called the standard procedure ‘‘exit’’. 
Dbx does not allow the process to exit, thereby letting the user to examine the program state. 


step Execute one source line. 


mext Execute up to the next source line. The difference between this and step is that if the line contains 
a call to a procedure or function the step command will stop at the beginning of that block, while 
the next command will not. 


return [procedure] 
Continue until a return to procedure is executed, or until the current procedure returns if none is 
specified. 

call procedure(parameters) 
Execute the object code associated with the named sgeeette or function. 


Printing Variables and Expressions 


Names are resolved first using the static scope of the current function, then using the dynamic scope if the 
name is not defined in the static scope. If static and dynamic searches do not yield a result, an arbitrary 
symbol is chosen and the message ‘‘[using qualified name]’’ is printed. The name resolution procedure 
may be overridden by qualifying an identifier with a block name, e.g., ‘‘module.variable’’. For C, source 
files are treated as modules named by the filename without ‘‘.c’’. 
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Expressions are specified with an approximately common subset of C and Pascal (or equivalently Modula- 
2) syntax. Indirection can be denoted using either a prefix ‘‘*’’ or a postfix ‘“*’’ and array expressions are 
subscripted by brackets (‘‘[ ]’’). The field reference operator (‘‘.’’) can be used with pointers as well as 
records, making the C operator ‘‘->’’ unnecessary (although it is supported). 
Types of expressions are checked; the type of an expression may be overridden by using ““type- 
SS , When there is no corresponding named type the special constructs “‘“&type-name 

and ‘‘$$zag-name’’ can be used to represent a pointer to a named type or C structure tag. , 


assign variable = expression 
Assign the value of the expression to the variable. 

dump [procedure] [> filename] 
Print the names and values of variables in the given procedure, or the currecit one if none is 
specified. If the procedure given is ‘‘.’’, then the all active variables are dumped. 


print expression [, expression ...] 
Print out the values of the expressions. 
whatis name 
Print the declaration of the given name, which may be qualified with block names as above. 
which identifier 
Print the full qualification of the given identifer, i.e. the outer blocks that the identifier is associ- 
ated with. 


up [count] 

down [count] 
Move the current function, which is used for resolving names, up or down the stack count levels. 
The default count is 1. 


where Print out a list of the active procedures and function. 


whereis identifier 
Print the full qualification of all the symbols whose name matches the given identifier. The order 
in which the symbols are printed is not meaningful. 


Accessing Source Files 


/regular expression{/] 
?regular expression(?) 
Search forward or backward in the current source file for the given pattern. 


edit [filename] 

edit procedure/function-name | 
Invoke an editor on filename or the current source file if none is specified. If a procedure or func- 
tion name is specified, the editor is invoked on the file that contains it. Which editor is invoked by 
default depends on the installation. The default can be overridden by setting the environment 
variable EDITOR to the name of the desired editor. 


file [filename] 
Change the current source filename to filename. If none is ee then the current source 
filename is printed. 


func [procedure/function] 
Change the current function. If none is specified then print the current function. Changing the 
current function implicitly changes the current source file to the one that contains the function; it 
also changes the current scope used for name resolution. 
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list [source-line-number [, source-line-number]] 

list procedure/function | 
List the lines in the current source file from the first line number to the second inclusive. If no 
lines are specified, the next 10 lines are listed. If the name of a procedure or function is given 
lines n-k to n+k are listed where n is the first statement in the procedure or function and & is small. 


use directory-list 
Set the list of directories tc be searched when looking for source files. 


Command Aliases and Variables 


alias name name 

alias name ‘‘string’’ 

alias name (parameters) ‘‘string’’ 
When commands are processed, dbx first checks to see if the word is an alias for either a com- 
mand or a string. If it is an alias, then dbx treats the input as though the corresponding string (with 
values substituted for any parameters) had been entered. For example, to define an alias “‘rr’’ for 
the command ‘“‘rerun’’, one can say 


alias rr rerun 
To define an alias called ‘‘b’’ that sets a stop at a particular line one can say 
alias b(x) ‘‘stop at x’’ 


Subsequently, the command ‘‘b(12)’’ will expand to ‘‘stop at 12’’. 


set name [= expression] 
The set command defines values for debugger variables. The names of these variables cannot 
conflict with names in the program being debugged, and are expanded to the corresponding 
expression within other commands. The following variables have a special meaning: 


$frame 
Setting this variable to an address causes dbx to use the stack frame pointed to by the 
address for doing stack traces and accessing local variables. This facility is of eee 
use for kernel debugging. 


$hexchars 

$hexints 

$hexoffsets 

$hexstrings 
When set, dbx prints out out characters, integers, offsets from registers, or character 
pointers respectively in hexadecimal. 


$listwindow 
The value of this variable specifies the number of lines to list around a function or when 
the list command is given without any parameters. Its default value is 10. 


$mapaddrs 
Setting (unsetting) this variable causes dbx to start (stop) mapping addresses. As with 
“‘$frame’’, this is useful for kernel debugging. 


' $unsafecall 
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$unsafeassign ‘ : 
When ‘‘$unsafecall’’ is set, strict type checking is tarned off for arguments to subrou- 
tine or function calls (e.g. in the call statement). When ‘‘Sunsafeassign’’ is set, strict 
type checking between the two sides of an assign statement is tumed off. These vari- 
ables should be used only with great care, because they severely limit dbx’s usefulness 


for detecting errors. 
unalias name 
Remove the alias with the given name. 
unset name 


Delete the debugger variable associated with name. 
Machine Level Commands 


tracei [address] [if cond] 
tracei [variable] [at address] [if cond] 
stopi [address] [if cond) 
stopi [at] [address] [if cond] 
Turn on tracing or set a stop using a machine instruction address. 


stepi 
nexti Single step as in step or next, but do a single instruction rather than source line. 


address ,address/ [mode] 

address | [count] [mode] 
Print the contents of memory starting at the first address and continuing up to the second address 
or until count items are printed. If the address is ‘‘.’’, the address following the one printed most 
recently is used. The mode specifies how memory is to be printed; if it is omitted the previous 
mode specified is used. The initial mode is ‘‘X’’. The following modes are supported: 


print the machine instruction 

print a short word in decimal 

print a long word in decimal 

print a short word in octal 

print a long word in octal 

print a short word in hexadecimal 
print a long word in hexadecimal 
print a byte in octal 

print a byte as a character 

print a string of characters terminated by a null byte 
print a single precision real number 
print a double precision real number 


menasmxoocua™ 


Symbolic addresses are specified by preceding the name with an ‘‘&’’. Registers are denoted by “‘$rN’’ 
where N is the number of the register. Addresses may be expressions made up of other addresses and the 
operators ‘‘+’’, ‘‘-’’, and indirection (unary ‘‘*’’). 
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Miscellaneous Commands 


gripe Invoke a mail program to send a message to the person in charge of dbx. 
help _ Print out a synopsis of dbx commands. 
quit Exit dbx. 


sh command-line , 
Pass the command line to the shell for execution. The SHELL environment variable determines 
which shell is used. 

source filename ; 
Read dbx commands from the given filename. 

OPTIONS 
—cfile Execute the dbx commands in the file before reading from standard input. 
-i Force dbx to act as though standard input is a terminal. 


-Idir Add dir to the list of directories that are searched when looking for a source file. Normally dbx 
looks for source files in the current directory and in the directory where objfile is located. The 
directory search path can also be set with the use command. 


—k Map memory addresses, useful for kernel debugging. 


—r Execute objfile immediately. If it terminates successfully dbx exits. Otherwise the reason for ter- 
mination will be reported and the user offered the option of entering the debugger or letting the 
program fault. Dbx will read from ‘‘/dev/tty’’ when —r is specified and standard input is not a ter- 
minal. 


Unless you specify the —r option, dbx just prompts and waits for a command. 


FILES 
a.out object file 
<dbxinit initial commands 
SEE ALSO 
ec(1), £77(1), pe(1), mod(1) 
COMMENTS 


Dbx suffers from the same ‘‘multiple include’ malady as did sdb. If you have a program consisting of a 
number of object files and each is built from source files that include header files, the symbolic information 
for the header files is replicated in each object file. Since about one debugger start-up is done for each link, 
having the linker (Id) re-organize the symbol information would not save much time, though it would 
reduce some of the disk space used. 


This problem is an artifact of the unrestricted semantics of #include’s in C; for example an include file can 
contain static declarations that are separate entities for each file in which they are included. However, even 
with Modula-2 there is a substantial amount of duplication of symbol information necessary for inter- 
module type checking. 


Some problems remain with the support for individual languages. Fortran problems include: inability to 
assign to logical, logical*2, complex and double complex variables; inability to represent parameter con- 
stants which are not type integer or real; peculiar representation for the values of dummy procedures (the 
value shown for a dummy procedure is actually the first few bytes of the procedure text; to find the location 
of the procedure, use ‘‘&’’ to take the address of the variable). 
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NAME 
de — desk calculator 


SYNOPSIS 
dc [ file ] 

DESCRIPTION 
Dec is an arbitrary precision arithmetic ee Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall structure 
of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file until its 
end, then from the standard input. The following constructions are recognized: 


number 
The value of the number is pushed on the stack. A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore _ to input a negative number. Numbers may contain decimal 
points. 

+—-/* %* 
The top two values on the stack are added (+), subtracted (—), multiplied (+), divided (/), remain- 
dered (%), or exponentiated (“). The two entries are popped off the stack; the result is pushed on 
the stack in their place. Any fractional part of an exponent is ignored. 


: interprets the rest of the line as a UNIX command. 

: A line of input is taken from the input source (usually the terminal) and executed. 
3: Are used by be for array operations. | 

[..] Puts the bracketed ascii string onto the top of the stack. 

c All values on the stack are popped. | 

d The top value on the stack is duplicated. 

f All values on the stack and in registers are printed. 


i The top value on the stack is popped and used as the number radix for further input. I pushes the 
input base on the top of the stack. 


k Pops the top of the stack, and uses that value as a non-negative scale factor: the appropriate number 
of places are printed on output, and maintained during multiplication, division, and exponentiation. 
The interaction of scale factor, input base, and output base will be reasonable if all are changed 
together. 


kx The value in register x is pushed on the stack. The register x is not altered. All registers start with 
zero value. 


Lx __ Treats register x as a stack and pops its top value onto the main stack. 

1) The top value on the stack is popped and used as the number radix for further output. 
oO Pushes the output base on the top of the stack. 

Pp 


The top value on the stack is printed. The top value remains unchanged. P interprets the top of the 
stack as an ascii string, removes it, and prints it. 


q Exits the program. If executing a string, the recursion level is popped by two. 

Q Pops the top value on the stack and pops the string execution level by that value. 

Sx The top of the stack is popped and stored into a register named x, where x may be any character. 
Sx Treats x as a stack and pushes the value on it. 

v 


Replaces the top element on the stack by its square root. Any existing fractional part of the argu- 
ment is taken into account, but otherwise the scale factor is ignored. 
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x Treats the top element of the stack as a character string and executes it as a string of dc commands. 
x Replaces the number on the top of the stack with its scale factor. 
<X DX &X 
The top two elements of the stack are popped and compared. Register x is executed if they obey the 
Stated relation. 


z The stack level is pushed onto the stack. 
Z Replaces the number on the top of the stack with its length. 


EXAMPLE 
An example which prints the first ten values of n! is 
[lal+dsa*plal0>y]sy 
Osal 
lyx 
SEE ALSO 


Bc(1), which is a preprocessor for dc providing infix notation and a C-like syntax which implements func- 
tions and reasonable control structures for programs. 


DIAGNOSTICS 
‘x is unimplemented’ where x is an octal number. 
“stack empty’ when there are not enough elements on the stack to carry out the request. 
‘Out of space’ when the free list is exhausted (too many digits). 
‘Out of headers’ when too many numbers are being retained. 
“Out of pushdown’ when there are too many items on the stack. 
‘Nesting Depth’ when there are too many levels of nested execution. 
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NAME 
dd — convert and copy a file 
SYNOPSIS 
dd [ option=value ) ... 
DESCRIPTION 
Dd copies the specified input file to the specified output with possible conversions. The standard input and 
output are used by defauit. The input and sas block size may be specified to take advantage of raw phy- 
sical /O. 
option values 
if= input filename; standard input is default 
of= Output filename; standard output is default 
ibs=n input block size bytes (default 512) 
obs=n output block size (default 512) 
bs=n set both input and output block size, superseding ibs and obs; also, if no conversion is 
specified, it is particularly efficient since no copy need be done 
cbs=n conversion buffer size 
skip=n skip m input records before starting copy 
files=n copy # input files before terminating (makes sense only where input is a magtape or 
similar device). 
seek=n seek m records from beginning of output file before copying 
count=n copy only z input records 
conv=ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
block convert variable length records to fixed length 
unblock — convert fixed length records to variable length 
Icase map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync pad every input record to ibs 
awk vie several comma-separated conversions 
Where sizes are specified, a number of bytes is expected. A number may end with k, b or w to specify 
multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a pro- 
duct. 
Cbs is used only if ascii, unblock, ebcdic, ibm, or block conversion is specified. In the first two cases, cbs 
characters are placed into the conversion buffer, any specified character mapping is done, trailing blanks 
trimmed and new-line added before sending the line to the output. In the latter three cases, characters are 
read into the conversion buffer, and blanks added to make up an output record of size cbs, 
After completion, dd reports the number of whole and partial input and output blocks. 
For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into the ASCII 
_ file x: 
dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii,lcase 
Note the use of raw magtape. Dd is especially suited to /O on the raw Bivens devices because it allows 
reading and writing in arbitrary record sizes. 
SEE ALSO 


cp(), tr(1) 
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DIAGNOSTICS 
f+p records in(out): numbers of full and partial records read(written) 


BUGS 
The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM Nov, 1968. 
The ‘ibm’ conversion, while less blessed as a standard, corresponds better to certain IBM print train con- 
ventions. There is no universal solution. 
One must specify ‘‘conv=noerror,sync’’ when copying raw disks with bad sectors to insure dd stays syn- 
chronized. 


Certain combinations of arguments to conv= are permitted. However, the block or unblock option cannot | 
be combined with ascii, ebcdic or ibm. Invalid combinations silently ignore all but the last mutually- 
exclusive keyword. 
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NAME 
deroff — remove nroff, troff, tbl and eqn constructs 


SYNOPSIS 
deroff [ options ] file ... 


DESCRIPTION 
Deroff reads each file in sequence and removes all nroff and troff command lines, backslash construc- 
tions, macro definitions, eqn constructs (between ‘.EQ’ and ‘.EN’ lines or between delimiters), and table 
descriptions and writes the remainder on the standard output. Deroff follows chains of included files (*.so’ 
and ‘.nx’ commands); if a file has already been included, a ‘.so’ is ignored and a ‘.nx’ terminates execution. 
If no input file is given, deroff reads from the standard input file. 
OPTIONS 
—w Prints the output as a word list, one ‘word’ (string of letters, digits, and apostrophes, beginning 
with a letter; apostrophes are removed) per line, and all other characters ignored. Otherwise, the 
output follows the original, with the deletions mentioned above. 


SEE ALSO 
troff(1), eqn(1), tbl(1) 


BUGS 
Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most errors result in 
too much rather than too little output. 
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NAME 
df — disk free 
SYNOPSIS 
df [ options } [ filesystem ...] {file ...] 
DESCRIPTION 
Df prints out the amount of free disk space available on the specified filesystem, e.g. ‘‘/dev/rp0a’’, or on the 
filesystem in which the specified file, e.g. ‘“SHOME”’, is contained. If no file system is specified, the free 
space on all of the normally mounted file systems is printed. The reported numbers are in kilobytes. 
OPTIONS 
-i Report also the number of inodes which are used and free. 


FILES 
/etc/fstab — list of normally mounted filesystems 


SEE ALSO 
fstab(5), icheck(8), quot(8) 
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NAME 

diction, explain — print wordy sentences; thesaurus for diction 

SYNOPSIS 
diction [ options ] file ... 
explain 

DESCRIPTION 
Diction finds all sentences in a document that contain phrases from a data base of bad or wordy diction. 
Diction prints out these sentences and brackets each wordy phrase with [ ]. Because diction runs deroff 
before looking at the text, formatting header files should be included as part of the input. 
Explain is an interactive thesaurus for the phrases found by diction. 

OPTIONS | 
-f pfile lets you supply your own pattern file to be used in addition to the default file. —m When used with 

—f pfile , suppresses the default file and searches for phrases found only in your own pattern file. 

—ml Causes deroff to skip lists, should be used if the document contains many lists of non-sentences. 
-—mm_ Overrides the default macro package —ms. 


SEE ALSO 
deroff(1) 


BUGS 


Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, diction is con- 
fused by —me, 
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NAME 


diff — differential file and directory comparator 


SYNOPSIS 


diff [4] [—r] [—s][—cefhn ] [ —biwt ] dir] dir2 
diff (—cefhn ] [ —biwt ] file! file2 
diff [ —Dstring } [ —biw ] filel file2 


DESCRIPTION 


If both arguments are directories, diff sorts the contents of the directories by name, and then runs the regu- 

lar file diff algorithm (described below) on text files which are different. Binary files which differ, com- 

mon subdirectories, and files which appear in only one directory are listed. Options when comparing direc- 

tories are: 

-l long output format; each text file diff is piped through pr(1) to paginate it, other differences are 
remembered and summarized after all text file differences are reported. 


-r causes application of diff recursively to common subdirectories encountered. 
-s causes diff to report files which are the same, which are otherwise not mentioned. 
—Sname 


Starts a directory diff in the middle beginning with file name. 


When run on regular files, and when comparing text files which differ during directory comparison, diff 
tells what lines must be changed in the files to bring them into agreement. Except in rare circumstances, 
diff finds a smallest sufficient set of file differences. If neither file] nor file2 is a directory, then either may 
be given as ‘—’, in which case the standard input is used. If file] is a directory, then a file in that directory 
whose file-name is the same as the file-name of file2 is used (and vice versa). 


There are several options for output format; the default output format contains lines of these forms: 


nl an3,n4 
nI n2 d n3 
nl ,n2 Cc n3,n4 


These lines resemble ed commands to convert file] into file2. The numbers after the letters pertain to file2. 
In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertain equally how to convert file2 into 
filel. As in ed, identical pairs where nJ = n2 or n3 = n4 are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by ‘<’, then all the 

lines that are affected in the second file flagged by ‘>’. 

Except for —b, -w, -i or -t which may be given with any of the others, the following options are mutually 

exclusive: 

—e produces a script of a, c and d commands for the editor ed, which will recreate file2 from file! . 
In connection with —e, the following shell program may help maintain multiple versions of a 
file. Only an ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) made by 
diff need be on hand. A ‘latest version’ appears on the standard output. 

(shift; cat $*; echo “1,$p’)| ed— $1 


Extra commands are added to the output when comparing directories with —e, so that the result 
is a sh(1) script for converting text files which are common to the two directories from their 
State in dir] to their state in dir2. 


-f - produces a script similar to that of —e, not useful with ed, and in the opposite order. 


—n produces a script similar to that of —e, but in the opposite order and with a count of changed 
lines on each insert or delete command. This is the form used by resdiff(1). 


—C produces a diff with lines of context. The default is to present 3 lines of context and may be 
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changed, e.g to 10, by —-c10. With —c the output format is modified slightly: the output begin- 
ning with identification of the files involved and their creation dates and then each change is 
separated by a line with a dozen *’s. The lines removed from file] are marked with ‘— ’; those 
added to file2 are marked ‘+’. Lines which are changed from one file to the other are marked in 
both files with with ‘! ’. 


Changes which lie within <context> lines of each other are grouped together on output. (This is 
a change from the previous ‘‘diff -c’’ but the resulting output is usually much easier to inter- 
pret.) 

-h does a fast, half-hearted job. It works only when changed stretches are short and well 
separated, but does work on files of unlimited length. 


—Dstring causes diff to create a merged version of file] and file2 on the standard output, with C prepro- 
cessor controls included so that a compilation of the result without defining string is equivalent 
to compiling file!, while defining string will yield file2. 


—b causes trailing blanks (spaces and tabs) to be ignored, and other strings of blanks to compare 
equal. 

—-w is similar to —b but causes whitespace (blanks and tabs) to be totally ignored. E.g., 
“if (a ==b )’’ will compare equal to ‘‘if(a==b)’’. 

-i ignores the case of letters. E.g., “‘A’’ will compare equal to ‘‘a’’. 

—t will expand tabs in output lines. Normal or —c output adds character(s) to the front of each line 


which may screw up the indentation of the original source lines and make the output listing 
difficult to interpret. This option will preserve the original source’s indentation. 


FILES 


/usr/lib/diffh for —h 

/bin/diff for directory diffs 

/bin/pr 
SEE ALSO 

cmp(1), ec(1), comm(1), ed(1), diff3(1) 
DIAGNOSTICS ; 

Exit status is 0 for no differences, 1 for some, 2 for trouble. 
BUGS 
Editing scripts produced under the —e or —f option are naive about creating lines consisting of a single ‘.’. 
When comparing directories with the —b, -w or -i options specified, diff first compares the files ala cmp, 
and then decides to run the diff algorithm if they are not equal. This may cause a small amount of spurious 
output if the files then turn out to be identical because the only differences are insignificant blank string or 
case differences. 
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NAME 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diff3 [-exEX3 ] file! file2 file3 


DESCRIPTION 


FILES 


Diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes: 
sans all three files differ 


a===] file] is different 
x===2 file2 is different 
| file3 is different 


The type of change suffered in converting a given range of a given file to some other is indicated in one of 
these ways: 


finla Text is to be appended after line number nJ in file f, where f = 1, 2, or 3. 
finl ,n2¢e Text is to be changed in the range line mJ to line n2. If nI = n2, the range may be 
abbreviated to nJ. 


The original contents of the range follows immediately after a c indication. When the contents of two files 
are identical, the contents of the lower-numbered file is suppressed. 


Under the —e option, diff3 publishes a script for the editor ed that will incorporate into file! all changes 
between file2 and file3, i.e. the changes that normally would be flagged ==== and ====3. Option —x (—3) 
produces a script to incorporate only changes flagged ==== (====3). The following command will apply 
the resulting script to ‘file1’. . 


ed — file1 


The —E and —X are similar to —e and —x, respectively, but treat overlapping changes (i.e., changes that 
would be flagged with ==== in the normal listing) differently. The overlapping lines from both files will be 
inserted by the edit script, bracketed by "<<<<<<" and ">>>>>>"” lines. 





(cat script; echo “1,$p’) 


For example, suppose lines 7-8 are changed in both filel and file2. Applying the edit script generated by 
the command 

"diff3 -E file! file2 file3" 
to file1 results in the file: 


lines 1-6 
of file! 
<<<<<<< file] 
lines 7-8 
of file1 
lines 7-8 

_ Of file3 
>>>>>>> file? — 
rest of file1 


The —E option is used by RCS merge(1) to insure that overlapping changes in the merged files are 
preserved and brought to someone’s attention. 


/emp/d3???7?? 
/usr/lib/diff3 
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SEE ALSO 
diff(1) 
BUGS 
Text lines that consist of a single ‘.’ will defeat —e. 
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NAME 
domainname - set or display name of current domain system 
SYNOPSIS 
domainname [ nameofdomain ] 
DESCRIPTION 
Without an argument, domainname prints the name of the current domain. With an argument, domain- 
name sets the domain’s name to be the argument. Only the super-user can set the domainname. Usually the 
domainname is set in the startup script /etc/rc.local. 
Currently, domains are used only by the yellow pages to refer collectively to a group of hosts. 
SEE ALSO 
ypinit(8) 
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NAME 
du — summarize disk usage 
SYNOPSIS 
du [ options ] [ name ... ] 
DESCRIPTION 
Du gives the number of kilobytes contained in all files and, recursively, directories within each specified 
directory or file name. If you do not specify a name, du begins counting from ‘.’. 
Used without options, du generates counts for each directory only. 
Du counts a file that has two links to it only once. 
OPTIONS 
—s Gives only the grand total of kilobytes. | 
—a Generates an entry for each file. Absence of either causes an entry to be generated for each direc- 
tory only. 
SEE ALSO 
df(1), quot(8) 


BUGS 
Non-directories given as arguments (not under —a option) are not listed. 
If there are too many distinct linked files, du counts the excess files multiply. 
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NAME 
echo — echo arguments 


SYNOPSIS 
echo [ options ] [ arg}... 
DESCRIPTION 
Echo writes its arguments separated by blanks and terminated by a newline on the standard output. 


Echo is useful for producing diagnostics in shell programs and for writing constant data on pipes. To send 
diagnostics to the standard error file, do ‘echo ... 1>&2’. 


OPTIONS 
—n Writes the arguments but does not add newlines to the output. 
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NAME 
ed — text editor 
SYNOPSIS 
ed [—][-x] [ name ] 


DESCRIPTION 
Ed is the standard text editor. 


If a name argument is given, ed simulates an e command (see below) on the named file; that is to say, the 
_ file is read into ed’s buffer so that it can be edited. If —x is present, an x command is simulated first to han- 

dle an encrypted file. The optional — suppresses the printing of explanatory output and should be used 

when the standard input is an editor script. 

Ed operates on a copy of any file it is editing; changes made in the copy have no effect on the file until a w 

(write) command is given. The copy of the text being edited resides in a temporary file called the buffer. 


Commands to ed have a simple and regular structure: zero or more addresses followed by a single charac- 
ter command, possibly followed by parameters to the command. These addresses specify one or more lines 
in the buffer. Missing addresses are supplied by default. 


In general, only one command may appear on a line. Certain commands allow the addition of text to the 
buffer. While ed is accepting text, it is said to be in input mode. In this mode, no commands are recog- 
nized; all input is merely collected. Input mode is left by typing a period ‘.’ alone at the beginning of a 
line. 


Ed supports a limited form of regular expression notation. A regular expression specifies a set of strings of 
characters. A member of this set of strings is said to be matched by the regular expression. In the follow- 
ing specification for regular.expressions the word ‘character’ means any character but newline. 


1 Any character except a special character matches itself. Special characters are the regular expres- 
sion delimiter plus \[. and sometimes * * $. 


A. matches any character. 
3. A \ followed by any character except a digit or () matches that character. 


A nonempty string s bracketed [s] (or [“s ]) matches any character in (or not in) s. Ins, \ has no 
special meaning, and ] may only appear as the first letter. A substring a—b, with a and b in 
ascending ASCII order, stands for the inclusive range of ASCII characters. 


5. A regular expression of form 1-4 followed by * matches a sequence of 0 or more matches of the 
regular expression. 


A regular expression, x, of form 1-8, bracketed \( x \) matches what x matches. 
- A\ followed by a digit n matches a copy of the string that the bracketed regular expression begin- 


ning with the nth \( matched. 

8. A regular expression of form 1-8, x, followed by a regular expression of form 1-7, y matches a 
match for x followed by a match for » with the x match being as long as possible while still per- 
mitting a y match. 

9. A regular expression of form 1-8 preceded by * (or followed by $), is constrained to matches that 


begin at the left (or end at the right) end of a line. 
10. A regular expression of form 1-9 picks out the longest among the leftmost matches in a line. 
11. An empty regular expression stands for a copy of the last regular expression encountered. 


Regular expressions are used in addresses to specify lines and in one command (see s below) to specify a 
portion of a line which is to be replaced. If it is desired to use one of the regular expression metacharacters 
as an ordinary character, that character may be preceded by ‘\’. This also applies to the character bounding 
the regular expression (often ‘/’) and to ‘\’ itself. 
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To understand addressing in ed it is necessary to know that at any time there is a current line. Generally 
speaking, the current line is the last line affected by a command; however, the exact effect on the current 
line is discussed under the description of the command. Addresses are constructed as follows. 


1 The character ‘.’ addresses the current line. 

2. The character ‘$’ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 
4 


‘’x’ addresses the line marked with the name x, which must be a lower-case letter. Lines are 
marked with the k command described below. 


=e A regular expression enclosed in slashes ‘/’ addresses the line found by searching forward from 
the current line and stopping at the first line containing a string that matches the regular expres- 
sion. If necessary the search wraps around to the beginning of the buffer. 


6. A regular expression enclosed in queries ‘?’ addresses the line found by searching backward from 
the current line and stopping at the first line containing a string that matches the regular expres- 
sion. If necessary the search wraps around to the end of the buffer. 


7. An address followed by a plus sign ‘+’ or a minus sign ‘—’ followed by a decimal number 
specifies that address plus (resp. minus) the indicated number of lines. The plus sign may be 
omitted. 

8. If an address begins with ‘+’ or ‘—’ the addition or subtraction is taken with respect to the current 
line; e.g. ‘~S’ is understood to mean ‘.—S’. 

9. If an address ends with ‘+’ or ‘—’, then 1 is added (resp. subtracted). As a consequence of this rule 


and rule 8, the address ‘—’ refers to the line before the current line. Moreover, trailing ‘+’ and ‘—’ 
characters have cumulative effect, so ‘—’ refers to the current line less 2. 


10. To maintain compatibility with earlier versions of the editor, the character ‘“’ in addresses is 
equivalent to ‘—’. 


Commands may require zero, one, or two addresses. Commands which require no addresses regard the 
presence of an address as an error. Commands which accept one or two addresses assume default 
addresses when insufficient are given. If more addresses are given than such a command requires, the last 
one or two (depending on what is accepted) are used. 


Addresses are separated from each other typically by a comma ‘,’. They may also be separated by a semi- 
colon ‘;’. In this case the current line ‘.’ is set to the previous address before the next address is inter- 
preted. This feature can be used to determine the starting line for forward and backward searches (‘/’, ‘?’). 
The second address of any two-address sequence must correspond to a line following the line correspond- 
ing to the first address. The special form ‘%’ is an abbreviation for the address pair ‘1,$’. 


In the following list of ed commands, the default addresses are shown in parentheses. The parentheses are 
not part of the address, but are used to show that the given addresses are the default. 

As mentioned, it is generally illegal for more than one command to appear on a line. However, most com- 
mands may be suffixed by ‘p’ or by ‘I’, in which case the current line is either printed or listed respectively 
in the way discussed below. Commands may also be suffixed by ‘n’, meaning the output of the command 
is to be line numbered. These suffixes may be combined in any order. 


(.)a 
<text> 


The append command reads the given text and appends it after the addressed line. ‘.’ is left on the 
last line input, if there were any, otherwise at the addressed line. Address ‘0’ is legal for this com- 
mand; text is placed at the beginning of the buffer. 


(a, )e 
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<text> 


The change command deletes the addressed lines, then accepts input text which replaces these lines. 
_*.” is left at the last line input; if there were none, it is left at the line preceding the deleted lines. 


(5.)d 
The delete command deletes the addressed lines from the buffer. The line originally after the last 
line deleted becomes the current line; if the lines deleted were originally at the end, the new last line 
becomes the current line. 


e filename 
The edit command causes the entire contents of the buffer to be deleted, and then the named file to 
be read in. ‘.’ is set to the last line of the buffer. The number of characters read is typed. ‘filename’ 
is remembered for possible use as a default filename in a subsequent r or w command. If ‘filename’ 
is missing, the remembered name is used. 


E filename 
This command is the same as e, except that no diagnostic results when no w has been given since the 
last buffer alteration. 


f filename 
The filename command prints the currently remembered filename. If ‘filename’ is given, the 
currently remembered filename is changed to ‘filename’. 


(1,$) g/regular expression/command list 
In the global command, the first step is to mark every line which matches the given regular expres- 
sion. Then for every such line, the given command list is executed with ‘.’ initially set to that line. 
A single command or the first of multiple commands appears on the same line with the global com- 
mand. All lines of a multi-line list except the last line must be ended with ‘\’. A, i, and c commands 
and associated input are permitted; the ‘.’ terminating input mode may be omitted if it would be on 
the last line of the command list. The commands g and v are not permitted in the command list. 


(.)i 
<text> 


This command inserts the given text before the addressed line. ‘.’ is left at the last line input, or, if 
there were none, at the line before the addressed line. This cananand differs from the a command 
only in the placement of the text. 


(., +1)j 
This command joins the addressed lines into a single une, intermediate newlines simply disappear. 
” is left at the resulting line. 
(. ye 


The mark command marks the addressed line with name x, which must be a lower-case letter. The 
address form ‘’x’ then addresses this line. 

(.,-)I 
The list command prints the addressed lines in an unambiguous way: non-graphic characters are — 
printed in two-digit octal, and long lines are folded. The / command may be placed on the same line 
after any non-i/o command. 

(.,.)ma 
The move command repositions the addressed lines after the line addressed by a. The last of the 
moved lines becomes the current line. 


(-5-)P 
The print command prints the addressed lines. ‘.’ is left at the last line printed. The p command 
may be placed on the same line after any non-i/o command. 
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(.,.)P 
This command is a synonym for p. 


q The quit command causes ed to exit. No automatic write of a file is done. 


Qs This command is the same as q, except that no diagnostic results when no w has been given since the 
last buffer alteration. 


($)r filename 
The read command reads in the given file after the addressed line. If no filename is given, the 
remembered filename, if any, is used (see e and f commands). The filename is remembered if there 
was no remembered filename already. Address ‘0’ is legal for r and causes the file to be read at the 
beginning of the buffer. If the read is successful, the number of characters read is he *.’ is left at 
the last line read in from the file. 


(.,.)S/regular expression/replacement/ __ or, 

( .,.)S/regular expression/replacement/g 
The substitute command searches each addressed line for an occurrence of the specified regular 
expression. On each line in which a match is found, all matched strings are replaced by the replace- 
ment specified, if the global replacement indicator ‘g’ appears after the command. If the global indi- 
Cator does not appear, only the first occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any punctuation character may be used instead of ‘/’ to 
delimit the regular expression and the replacement. ‘.’ is left at the last line substituted. 


An ampersand ‘&’ appearing in the replacement is replaced by the string matching the regular 
expression. The special meaning of ‘&’ in this context may be suppressed by preceding it by ‘\’. 

_ The characters ‘\n’ where n is a digit, are replaced by the text matched by the n-th regular subex- 
pression enclosed between ‘\(’ and ‘\)’. When nested, parenthesized subexpressions are present, 7 is 
determined by counting occurrences of ‘\(’ starting from the left. 


Lines may be split by substituting new-line characters into them. The new-line in the replacement 
string must be escaped by preceding it by ‘\’. 


One or two trailing delimiters may be omitted, implying the ‘p’ suffix. The special form ‘s’ followed 
by no delimiters repeats the most recent substitute command on the addressed lines. The ‘s’ may be 
followed by the letters r (use the most recent regular expression for the left hand side, instead of the 
most recent left hand side of a substitute command), p (complement the setting of the p suffix from 
the previous substitution), or g (complement the setting of the g suffix). These letters may be com- 
bined in any order. 


(.,.)ta 
This command acts just like the m command, except that a copy of the addressed lines is placed after 
address a (which may be 0). ‘.’ is left on the last line of the copy. 


(.,.)uU 
The undo command restores the buffer to it’s state before the most recent buffer modifying com- 
mand. The current line is also restored. Buffer modifying commands are a, c, d, g, i, k, and v. For 
purposes of undo, g and v are considered to be a single buffer modifying command. Undo is its own 
inverse. 


When ed runs out of memory (at about 8000 lines on any 16 bit mini-computer such as the PDP-11) 
This full undo is not possible, and u can only undo the effect of the most recent substitute on the 
current line. This restricted undo also applies to editor scripts when ed is invoked with the - option. 


(1, $) v/regular expression/command list 
This command is the same as the global command g except that the command list is executed g with 
‘.’ initially set to every line except those matching the regular expression. 


(1, $) w filename 
The write command writes the addressed lines onto the given file. If the file does not exist, it is 
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created. The filename is remembered if there was no remembered filename already. If no filename 
is given, the remembered filename, if any, is used (see e and f commands). ‘.’ is unchanged. If the 
command is successful, the number of characters written is printed. 


(1,.$) W filename 
This command is the same as w, except thatthe addressed lines are appended to the file. 


(1, $) wq filename 
This command is the same as w except that afterwards aq command i is done, exiting the editor after 
the file is written. 


x A key string is demanded from the standard input. Lace r, e and w commands will encrypt and 
decrypt the text with this key by the algorithm of crypt(1). An explicitly empty key turns off 
encryption. (.+1)z or, 

(.+1) zn 
This command scrolls through the buffer starting at the addressed line. 22 (or n, if given) lines are 
printed. The last line printed becomes the current line. The value n is sticky, in that it becomes the 
default for future z commands. 


($)= The line number of the addressed line is typed. ‘.’ is unchanged by this command. 


!<shell command> 
The remainder of the line after the ‘!’ is sent to sh(1) to be interpreted as a command. ‘.’ is 
unchanged. 


(.+1, +1) <newline> | 
An address alone on a line causes the addressed line to be printed. A blank line alone is equivalent 
to ‘.+1p’; it is useful for stepping through text. If two addresses are present with no intervening 
semicolon, ed prints the range of lines. If they are separated by a semicolon, the second line is 
printed. 
If an interrupt signal (ASCII DEL) is sent, ed prints ‘?interrupted’ and returns to its command level. 
Some size limitations: 512 characters per line, 256 characters per global command list, 64 characters per 
filename, and, on mini computers, 128K characters in the temporary file. The limit on the number of lines 
depends on the amount of core: each line takes 2 words. 
When reading a file, ed discards ASCII NUL characters and all characters after the last newline. It refuses 
to read files containing non-ASCII characters. 
FILES . 
/tmp/e* 
edhup: work is saved here if terminal hangs up 
SEE ALSO 
B. W. Kernighan, A Tutorial Introduction to the ED Text Editor 
B. W. Kernighan, Advanced editing on UNIX 
ex(1), sed(1), crypt(1) 
DIAGNOSTICS 
‘tmame’ for inaccessible file; ‘?self-explanatory message’ for other errors. 
To protect against throwing away valuable work, a q or e command is considered to be in error, unless a w 
has occurred since the last buffer change. A second q or e will be obeyed regardless. 
BUGS — 
The / command mishandles DEL. 


The undo command causes marks to be lost on affected lines. 
The x command, -x option, and special treatment of hangups only work on UNIX. 
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NAME 

efi — Extended Fortran Language 
SYNOPSIS 

efi [ option ...] [ filename ... ] 
DESCRIPTION 


Efi compiles a program written in the EFL language into clean Fortran. Efi provides the same control flow 
constructs as does ratfor(1), which are essentially identical to those in C: 


Statement grouping with braces; 
decision-making with if, if-else, and switch-case; while, for, Fortran do, repeat, and repeat...until 
loops; multi-level break and next. In addition, EFL has C-like data structures, and more uniform 
and convenient input/output syntax, generic functions. EFL also provides some syntactic sugar to 
make programs easier to read and write: 


free form input: . . 
multiple statements/line; automatic continuation statement label names (not just numbers), 


comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 
include: include filename 


If a command argument contains an embedded equal sign, that argument is treated as if it had appeared in 
an option statement at the beginning of the program. Efl is best used with f77(1). 


OPTIONS 
—-# Prevents comments from being copied through to the Fortran output. 


-C Causes comments to be copied through to the Fortran output (default). 
—-w suppresses warning messages. 


SEE ALSO 
f77(1), ratfor(1). 
S. I. Feldman, The Programming Language EFL, Bell Labs Computing Science Technical Report #78. 
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delim $$ 
NAME 
eqn, neqn, checkeq — typeset mathematics 
SYNOPSIS 
eqn [ options ] [ file}... 
| checkeg [ file } ... 
DESCRIPTION 
Eqn is a troff(1) preprocessor for typesetting mathematics on a Graphic Systems phototypesetter. Neqn is 
the corresponding prepocessor for typsetting mathematics on terminals. Usage is almost always: 
eqn file ... | troff 
neqn file ... | nroff 
If no files are specified, these programs read from the standard input. A line beginning with ‘EQ’ marks 
the start of an equation; the end of an equation is marked by a line beginning with ‘EN’. Neither of these 
lines is altered, so they may be defined in macro packages to get centering, numbering, etc. It is also possi- 
ble to set two characters as ‘delimiters’; subsequent text between delimiters is also treated as eqn input. 
Delimiters may be set to characters x and y with the command-line argument —dxy or (more commonly) 
with ‘delim xy’ between .EQ and .EN. The left and right delimiters may be identical. Delimiters are 
turned off by ‘delim off’. All text that is neither between delimiters nor between EQ and EN is passed 
through untouched. 


The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 


Tokens within eqn are separated by spaces, tabs, newlines, braces, double quotes, tildes or circumflexes. 
Braces {} are used for grouping; generally speaking, anywhere a single character like x could appear, a 
complicated construction enclosed in braces may be used instead. Tilde “ represents a full space in the out- 
put, circumflex * half as much. 7 | 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes $x sub i$, a 
sub i sup 2 produces $a sub i sup 2$, and e sup {x sup 2 + y sup 2} gives $e sup {x sup 2 + y sup 2}5. 


Fractions are made with over: a over b yields $a over b$. 
Sqrt makes square roots: 1 over sqrt {ax sup 2 +bx+c} results in $1 over sqrt {ax sup 2 +bx+c}$. 


‘The keywords from and to introduce lower and upper limits on arbitrary things: $lim from {n-> inf} sum 
from 0 to n x sub i$ is made with lim from {n—> inf } sum from 0 to n x sub i. 


Left and right brackets, braces, etc., of the right height are made with left and right: left [ x sup 2 + y sup 
2 over alpha right ] “="1 produces $left [ x sup 2 + y sup 2 over alpha right ] “="1$. The right clause is 
optional. Legal characters after left and right are braces, brackets, bars, ¢ and f for ceiling and floor, and 
"" for nothing at all (useful for a right-side-only bracket). 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: pile {a above b above c} produces $pile 
{a above b above c}$. There can be an arbitrary number of elements in a pile. Ipile left justifies the pile, 
pile and cpile center it, with different vertical spacing, and rpile right justifies the pile. 


Matrices are made with matrix: matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2 } } produces 
$matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2 } }$. rceol produces a right-justified column. 


Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot = f(t) bar is $x 
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dot = f(t) bar$, y dotdot bar “=" n under is $y dotdot bar “=" n under$, and x vec “=" y dyad is $x vec "=" 
y dyad$. 


Sizes and font can be changed with size n or size +n, roman, italic, bold, and font n. Size and fonts can be 
changed globally in a document by gsize n and gfont n, or by the command-line options —sn and —fn. 


Normally subscripts and superscripts are reduced by 3 point sizes from the previous size. You can change 
the number of points with the command-line options —pn. Successive display arguments can be lined up. 
Place mark before the desired lineup point in the first equation; place lineup at the place that is to line up 
vertically in subsequent equations. 

Shorthands may be defined or existing keywords redefined with define: define thing % replacement % 
defines a new token called thing which will be replaced by replacement whenever it appears thereafter. 
The % may be any character that does not occur in replacement. 

Keywords like sum ( sum ) int ( int ) inf ( inf ) and shorthands like >= (>=) —> (->), and != ( != ) are recog- 
nized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. Mathematical words like 
sin, cos, log are made Roman automatically. Troff(1) four-character escapes like \(em (—) can be used 
anywhere. Strings enclosed in double quotes "..." are passed through untouched; this permits keywords to 
be entered as text, and can be used to communicate with troff when all else fails. 


OPTIONS 
—dxy Sets the the start delimiter to x and the end delimiter to y. 


—fn Globally sets the font to font x. 


—pn Sets the number of point sizes by which eqn reduces subscripts and superscripts to n. Normally, 
eqn reduces subscripts and superscripts by 3 point sizes from the standard point size. 


—sn Globally sets the font size to ” points. 


SEE ALSO 
troff(1), tbl(1), ms(7), eqnchar(7) 
B. W. Kernighan and L. L. Cherry, Typesetting Mathematics—User’ s Guide 
J. F. Ossanna, NROFF/TROFF User's Manual 


BUGS 
To embolden digits, parens, etc., it is necessary to quote them, as in ‘bold "12,3". 
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NAME 
error — analyze and disperse compiler error messages 


SYNOPSIS 
error [ options ] [ name } 


DESCRIPTION ; 
Error analyzes and optionally disperses the diagnostic error messages produced by a number of compilers 
and language processors to the source file and line where the errors occurred. It can replace the painful, 
traditional methods of scribbling abbreviations of errors on paper, and permits error messages and source 
code to be viewed simultaneously without machinations of multiple windows in a screen editor. 


Error looks at the error messages, either from the specified file name or from the standard input, and 
attempts to determine which language processor produced each error message, determines the source file 
and line number to which the error message refers, determines if the error message is to be ignored or not, 
and inserts the (possibly slightly modified) error message into the source file as a comment on the line 
preceding to which the line the error message refers. Error messages which can’t be categorized by 
language processor or content are not inserted into any file, but are sent to the standard output. Error 
touches source files only after all input has been read. By specifying the —q query option, the user is asked 
to confirm any potentially dangerous (such as touching a file) or verbose action. Otherwise error proceeds 
on its merry business. If the —t touch option and associated suffix list is given, error will restrict itself to 
touch only those files with suffices in the suffix list. Error also can be asked (by specifying —v) to invoke 
vi(1) on the files in which error messages were inserted; this obviates the need to remember the names of 
the files with errors. 


Error is intended to be run with its standard input connected via a pipe to the error message source. Some 
language processors put error messages on their standard error file; others put their messages on the stan- 
dard output. Hence, both error sources should be piped together into error. For example, when using the 
csh syntax, 


make —s lint | & error —q —v . | 
will analyze all the error messages produced by whatever programs make runs when making lint. 


Error knows about the error messages produced by: make, cc, cpp, ccom, as, Hd, lint, pi, pc, f77, and 
DEC Western Research Modula-2. Error knows a standard format for error messages produced by the 
language processors, so is sensitive to changes in these formats. For all languages except Pascal, error 
messages are restricted to be on one line. Some error messages refer to more than one line in more than 
one files; error will duplicate the error message and insert it at all of the places referenced. 


Error will do one of six things with error messages. 


synchronize 
Some language processors produce short errors describing which file it is processing. Error 
uses these to determine the filename for languages that don’t include the filename in each error 
message. These synchronization messages are consumed entirely by error. 


discard _—_ Error messages from lint that refer to one of the two lint libraries, /usr/lib/llib-lc and 
lusr/lib/llib-port are discarded, to prevent accidently touching these libraries. Again, these 
_ efror messages are consumed entirely by error. 


nullify Error messages from lint can be nullified if they refer to a specific function, which is known to 
generate diagnostics which are not interesting. Nullified error messages are not inserted into 
_ the source file, but are written to the standard output. The names of functions to ignore are 
taken from either the file named .errorrc in the users’s home directory, or from the file named 
by the —I option. If the file does not exist, no error messages are nullified. If the file does 
exist, there must be one function name per line. 


not file specific . 
Error messages that can’t be intuited are grouped together, and written to the standard output 
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before any files are touched. They will not be inserted into any source file. 


file specific Error message that refer to a specific file, but to no specific line, are written to the standard out- 
put when that file is touched. 


true errors Error messages that can be intuited are candidates for insertion into the file to which they refer. 


Only true error messages are candidates for inserting into the file they refer to. Other error messages are 
consumed entirely by error or are written to the standard output. Error inserts the error messages into the 
source file on the line preceding the line the language processor found in error. Each error message is 
turned into a one line comment for the language, and is internally flagged with the string ‘‘###’’ at the 
beginning of the error, and ‘‘%%%’’ at the end of the error. This makes pattern searching for errors easier 
with an editor, and allows the messages to be easily removed. In addition, each error message contains the 
source line number for the line the message refers to. A reasonably formatted source program can be 
recompiled with the error messages still in it, without having the error messages themselves cause future 
errors. For poorly formatted source programs in free format languages, such as C or Pascal, it is possible to 
insert a comment into another comment, which can wreak havoc with a future compilation. To avoid this, 
programs with comments and source on the same line should be formatted so that language statements 
appear before comments. 


Error catches interrupt and terminate signals, and if in the insertion phase, will orderly terminate what it is 
doing. 


OPTIONS 


FILES 


BUGS 


~lignorefile 
Retrieves the list of functions to be ignored from ignorefile. 
~-n Does not touch any files; all error messages are sent to the standard output. 


—q Queries the user whether he or she wants to touch the file. A ‘‘y’’ or ‘‘n’’ to the question is neces- 
sary to continue. Absence of the —q option implies that all referenced files (except those referring to 
discarded error messages) are to be touched. 


-S Prints out statistics regarding the error categorization. Not always useful. 

—tsuffixlist 
Takes the following argument as a suffix list. Files whose suffixes do not appear in the suffix list are 
not touched. The suffix list is dot separated, and ‘‘*’’ wildcards work. Thus the suffix list: 


".c.y.foo*.h" 
allows error to touch files ending with ‘‘.c’’, “‘.y’’, ‘*.foo*’’ and ““.y’’. 


—v After all files have been touched, overlays the visual editor vi with it set up to edit all files touched, 
and positioned in the first touched file at the first error. If vi can’t be found, try ex or ed from stan- 


dard places. 
“/.errorrc function names to ignore for lint error messages 
/dev/tty user’s teletype 


Opens the teletype directly to do user querying. 
Source files with links make a new copy of the file with only one link to it. 


Changing a language processor’s format of error messages may cause error to not understand the error 
message. 


Error, since it is purely mechanical, will not filter out subsequent errors caused by ‘floodgating’ initiated 
by one syntactically trivial error. Humans are still much better at discarding these related errors. 
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Pascal error messages belong after the lines affected (error puts them before). The alignment of the ‘|’ 
marking the point of error is also disturbed by error. 


Error was designed for work on CRT’s at reasonably high speed. It is less pleasant on slow speed termi- 
nals, and has never been used on hardcopy terminals. 
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NAME 
ex, edit — text editor 


SYNOPSIS 
ex [—] {-v] [-t tag] [-—r] [+command ] [-1] name ... 
edit [-— ] [-v ] [-t tag } [-r ] [ +command | [-1] name ... 


DESCRIPTION 
Ex is the root of a family of editors: edit, ex and vi. Ex is a superset of ed, with the most notable extension 
being a display editing facility. Display based editing is the focus of vi. | 
If you have not used ed or if you are only a casual user, you will find that edit is a convenient editor for 
you. It avoids some of the complexities of ex used mostly by systems programmers and persons fluent with 
ed. 


If you have a CRT terminal, you may wish to use a display based editor. See vi(1), a command that focuses 
on the display editing portion of ex. 


For information about command line options and other features of these editors, see the documentation 
listed below. 


DOCUMENTATION 
The document Edit: A tutorial (USD:14) provides a comprehensive introduction to edit assuming no previ- 
ous knowledge of computers or the UNIX system. 


The Ex Reference Manual — Version 3.7 (USD:16) is a comprehensive and complete manual for the com- 
mand mode features of ex, but you cannot learn to use the editor by reading it. For an introduction to more 
advanced forms of editing using the command mode of ex see the editing documents written by Brian Ker- 
nighan for the editor ed; the material in the introductory and advanced documents works also with ex. 


An Introduction to Display Editing with Vi (USD:15) introduces the display editor vi and provides refer- 
ence material on vi. In addition, the Vi Quick Reference card summarizes the commands of vi in a useful, 
functional way, and is useful with the Introduction. 


FILES 
/usr/lib/ex?.?strings error messages 
/usr/lib/ex?.?recover recover command 
/usr/lib/ex?.?preserve preserve command 
/etc/termcap describes capabilities of terminals 
“/,exrc editor startup file 
/‘tmp/Exnnnnn editor temporary 
/tmp/Rxnnnnn named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 
awk(1), ed(1), grep(1), sed(1), grep(1), vi(1), termcap(5), environ(7) 
BUGS 


The undo command causes all marks to be lost on lines changed and then restored if the marked lines were 
changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical lines. More than a screen full of output 
may result if long lines are present. 


File input/output errors don’t print a name if the command line ‘~—’ option is used. 
There is no easy way to do a single scan ignoring case. 
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The editor does not warn if text is placed in named buffers and not used before exiting the editor. 
Null characters are discarded in input files, and cannot appear in resultant files. 


June 5, 1986 INTEGRATED SOLUTIONS 4.3 BSD 2: 


EXPAND (1) UNIX Programmer’s Manual EXPAND (1) 


NAME 
expand, unexpand — expand tabs to spaces, and vice versa 


SYNOPSIS 
expand [ —tabstop } { -tab1,tab?2.,...,tabn ] [ file ... ] 
unexpand [ —a } [file ... ] 


DESCRIPTION 
Expand processes the named files or the standard input writing the standard output with tabs changed into 
blanks. Backspace characters are preserved into the output and decrement the column count for tab calcu- 
lations. Expand is useful for pre-processing character files (before sorting, looking at specific columns, 
etc.) that contain tabs. 


If a single tabstop argument is given, then tabs are set tabstop spaces apart instead of the default 8. If mul- 
tiple tabstops are given then the tabs are set at those specific columns. 


Unexpand puts tabs back into the data from the standard input or from the named files, then writes the 
result on the standard output. By default, only leading blanks and tabs are reconverted to maximal strings 
of tabs. If you specify the —a option, unexpand inserts tabs where ever they would compress the resultant 
file by replacing two or more characters. 
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NAME 
expr — evaluate arguments as an expression 


SYNOPSIS 
expr arg... 
DESCRIPTION 


The arguments are taken as an expression. After evaluation, the result is written on the standard output. 
Each token of the expression is a separate argument. 


The operators and keywords are listed below. The list is in order of i increasing precedence, with equal pre- 
cedence operators grouped. 


expr | expr 
yields the first expr if it is neither null nor ‘O’, otherwise yields the second expr. 


expr & expr 
yields the first expr if neither expr is null or ‘0’, otherwise yields ‘0’. 

expr relop expr 
where relop is one of < <= = != >= >, yields ‘1’ if the indicated comparison is true, ‘0’ if false. 
The comparison is numeric if both expr are integers, otherwise lexicographic. 


expr + expr 

expr — expr 
addition or subtraction of the arguments. 

expr * expr 

expr { expr 

expr % expr 
multiplication, division, or remainder of the arguments. 

expr : expr 
The matching operator compares the string first argument with the regular expression second 
argument; regular expression syntax is the same as that of ed(1). The \(...\) pattern symbols can 
be used to select a portion of the first argument. Otherwise, the matching operator yields the 
number of characters matched (‘0’ on failure). 


( expr ) parentheses for grouping. 


EXAMPLES 
. To add 1 to the Shell variable a: 


a= expr $a + 1° 
To find the filename part (least significant part) of the pathname stored in variable a, which may or may not 
contain ‘/’: 

expr $a: “.*/A(.*\)° “|’ $a 
Note the quoted Shell metacharacters. 


SEE ALSO 
sh(1), test(1) 
DIAGNOSTICS 
Expr returns the following exit codes: 
0 if the expression is neither null nor ‘0’, 
1 if the expression is null or ‘0’, 
2 for invalid expressions. 
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NAME 
f77 — Fortran 77 compiler 


SYNOPSIS 
77 [ options } fules 

DESCRIPTION . 
F77 is an optimizing Fortran 77 compiler. F77 accepts several types of arguments: 
Arguments whose names end with ‘.f are Fortran 77 source programs; they are compiled and left in a ‘.o” 
file in the working directory. 
Arguments whose names end with ‘.F’ are preprocessed with the C preprocessor before they are compiled 
by f77. 
Arguments whose names end with ‘.’ are Ratfor programs; they are processed by /usr/bin/ratfor before 
they are compiled by f77. 
Arguments whose names end with ‘.s’ are assembly language source programs; they are assembled and left 
in a ‘.o’ file in the working directory. 
The *.o’ file is deleted if a single source file is compiled and linked. 
F77 creates ‘.s’ files for each module if the user compiles with the —S option. 

OPTIONS 
F77 accepts the options listed below. Additional options are supported by Id(1). 


—20 Generates code for a 68020 CPU. To maintain compatibility with old code, the alignment rules 
are not changed unless you specify -X134. This alignment forces longwords to 32 bit boun- 
daries. 


—€ Compiles to the ‘.o’ level only. Does not link. 
-C Does not strip comments from the preprocessor output. Must be used with the —E option. 


~—Dname=def 

—Dname Defines the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". 

-E Does not compile the program; instead, it places the output of the preprocessor in the standard 
output file. This is useful for debugging preprocessor macros. The integrated preprocessor can- 
not generate output as fast as cpp(1), so use cpp(1) for big jobs. 


-f Generates code which assumes the presence of a 68881 coprocessor. By default many of the 
functions supported by the 68881 will be inline as well. Use -Z139 if you want a transcenden- 
tal call to go to the routine instead. 


—F Preprocess the ‘.r’ or ‘.F’ files given to ‘.f, but do not compile. 

-g Generates BSD style debugger information in the assembly file, for use with a debugger such 
_as dbx(2). 

—ga Generates a stack frame for every routine, regardless of need. 

-k Prevents the compiler from optimizing an "and" with a single bit into a BTST instruction. 


(Some devices require word acess to their registers while BTST is a byte access instruction.) 


-Idir ‘#include’ files whose names do not begin with "/" are always sought first in the directory of 
the file argument, then in directories named in —I options, then in /usr/include. 


—m Preprocesses ratfor programs with M4. 


—O output Names the final output file output. If you use this option, f77 will leave the file ‘a.out’ undis- 
turbed. 
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—onetrip Ensures that DO loops are executed at least once. 

—O Performs various speed optimizations, such as moving constant expressions out of loops. Gen- 
erally this will make your programs somewhat larger; if their aaa is not loop bound, 
they may become slower as well. 

—OQ2 Allows the optimizer to assume that memory locations do not change except by explicit stores. 
That is, this option guarantees the optimizer that no memory locations are I/O device registers 
that can be changed by external hardware and that no memory locations are being shared with 
other processes which can change them asynchronously with respect to the current process. 
Use this compile time option with extreme caution (or not at all) in device drivers, operating 
systems, shared memory environments, and when interrupts (or UNIX signals) are present. 

—p Generates profiling code, in a manner similar to ec(1), and links the code with routines which 
support prof(1). 

—pg Generates profiling code similar to —p, but link with a more comprehensive profiling mechan- 
ism which supports gprof(1). 

-R Makes initialized variables part of the text segment; passed on to as. 

-Rstring Pass string along to ratfor as an option. 

-S Compiles the named programs and leaves the assembler-language output on corresponding 
files suffixed ‘.s’. 

—u Makes all variables ‘undefined’ unless declared. 

-U Retain character case significance. By default, identifiers are converted to lower case. 

—Uname Removes any initial definition of name. . 

—-VvV Turns on verbose mode. In verbose mode, f77 prints out the arguments to each phase of com- 
pilation and linking. 

-w Suppresses warning messages. 

—-Xn Where 7 is an integer constant, turns on option number n. There are numerous options avail- 
able for such things as signed bit fields, short return types, etc. You can find descriptions of 
these options in Section 8 of the UNIX Compiler Guide: C, Pascal, FORTRAN 77. 

—Zn Turns off option number 1. You can use —Z to turn off options that are on by default. You can 
also use it to tum off options you turned on with —X. 

FILES 
file.[fFrresc] source input file 
' file.o object file 

a.out loaded output 

/bin/as assembler 

Nib/cpp C preprocessor 

/usr/lib/libc.a UNIX standard /O library 

/usr/lib/libmc.a UNIX standard I/O library for the 68020/6888 1 

/usr/lib/libmc_p.a profiling UNIX standard I/O library for the 68020/6888 1 

/usr/lib/libc_p.a profiling UNIX standard I/O library 

/usr/lib/fcom Fortran compiler 

/usr/lib/gcrt0.o* profiling startup code - IEEE floating point 

/usr/lib/libF77.a Fortran intrinsic function library 

/ust/lib/libF77_p.a profiling intrinsic function library 

/ust/lib/lib166.a Fortran I/O library for Fortran 66 

/usr/lib/libI77.a Fortran I/O library 

/asr/lib/libI77_p.a profiling Fortran I/O library 

_ fasr/ib/libU77.a UNIX interface library 
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/usr/lib/libU77_p.a 
/usr/lib/libmU77.a 
/usr/lib/libmU77_p.a 
/usr/lib/libmF77.a 
/usr/lib/libmF77_p.a 
/usr/lib/libmI77.a 
/usr/lib/libmI77_p.a 
/usr/lib/libm.a 
/usr/lib/libm_p.a 
/usr/lib/libmm.a 
/usr/lib/libmm_p.a 
/usr/lib/libSkyF77.a 
/usr/lib/libSkyF77_p.a 
/usr/lib/libSkyI77.a 
/usr/lib/libSky177_p.a 
fusr/lib/libSkyU77.a 
/usr/lib/libSkyU77_p.a 
/usr/lib/libSkyc.a 
/usr/lib/libSkyc_p.a 
/usr/lib/libSkym.a 
/usr/lib/libSkym_p.a 
/usr/lib/Skycrt0.o* 
/usr/lib/Skygcrt0.o* 
/usr/lib/Skymcrt0.o* 
mon.out 

gmon.out 


SEE ALSO 
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profiling UNIX interface library 

UNIX interface library compiled for the 68020/6888 1 
profiling UNIX interface library for the 68020/6888 1 
Fortran intrinsic functions for the 68020/68881 
profiling intrinsic functions for the 68020/6888 1 
Fortran I/O library for the 68020/6888 1 

profiling Fortran I/O library 68020/6888 1 

Intrinsic floating point math library 

profiling intrinsic floating point library 

68020/6888 1 intrinsic floating point math library 
68020/68881 intrinsic float point math library 
Fortran intrinsic library compiled for the Sky FFP 
profiling Fortran intrinsic library for Sky FFP 

Fortran I/O library compiled for the Sky FFP 
profiling Fortran I/O library compiled for the Sky FFP 
Fortran UNIX library compiled for the Sky FFP 
profiling Fortran UNIX library vompiled for the Sky FFP 
Standard I/O library compiled for Sky FFP 

profiling Stand. I/O library compiled for Sky FFP 
instinsic math library for Sky board 

profiling transcendental math library for Sky board 
Sky startup code. 

Sky profiling startup routine for gprof profiling 

Sky profiling for prof startup 

file produced for analysis by prof(1) 

file produced for analysis by gprof(1) 


UNIX Compiler Guide: C, Pascal, FORTRAN 77 
as(1), cc(1), pe(1), prof(1), gprof(1), adb(1), dbx(1), Id(1), ratfor(1), m4(1) 


DIAGNOSTICS 


The diagnostics produced by the f77 compiler are intended to be self-explanatory and similar to those pro- 
duced by the BSD f77 compiler. Occasional messages may be produced by the assembler or loader. 
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NAME 
false, true — provide truth values 
SYNOPSIS 
true 
false 
DESCRIPTION ki 
True and false are usually used in a Bourne shell script. They test for the appropriate status "true" or 
“false” before running (or failing to run) a list of commands. 
EXAMPLE | 
while false 
do 
command list 
done 
SEE ALSO 
esh(1), sh(1), true(1) 
DIAGNOSTICS 
False has exit status nonzero. 
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NAME 

file — determine file type 
SYNOPSIS 

file file ... 


DESCRIPTION 
File performs a series of tests on each argument in an attempt to classify it. If an argument appears to be 
ascii, file examines the first 512 bytes and tries to guess its language. 


BUGS 
File often makes mistakes. In particular it often suggests that command files are C programs. 


File does not recognize Pascal or LISP. 
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NAME 
find — find files 


SYNOPSIS 
find pathname-list expression 
find paitern 

DESCRIPTION 
In the first form above, find eourively descends the directory hierarchy for each pathname in the 
pathname-list (i.e., one or more pathnames) seeking files that match a boolean expression written in the pri- 
maries given below. In the descriptions, the argument n is used as a decimal integer where +n means more 
than x, —n means less than n and 7 means exactly n. 


The second form rapidly searches a database for all pathnames which match pattern. Usually the database 
is recomputed weekly and contains the pathnames of all files which are publicly accessible. If escaped, 
normal shell ‘‘globbing’’ characters (‘*’, ‘?’, ‘[’, and ’}’) may be used in pattern, but the matching differs 
in that no characters (e.g. ‘/’) have to be matched explicitly. As a special case, a simple pattern containing 
no globbing characters is matched as though it were *pattern*; if any globbing character appears there are 
no implicit globbing characters. ; 


—name filename 
True if the filename argument matches the current filename. Normal shell argument syntax 
may be used if escaped (watch out for ‘[’, ‘?’ and ‘*’). 


—perm onum 
True if the file permission flags exactly match the octal number onwm (see chmod(1)). If 
onurn is prefixed by a minus sign, more flag bits (017777, see stat(2)) become significant and 
the flags are compared: (flagskonum)==onum. 


—typec —_ True if the type of the file is c, where c is b, c, d, f, | or s for block special file, character spe- 
cial file, directory, plain file, symbolic link, or socket. 


—linksn True if the file has 7 links. 


—user uname 
True if the file belongs to the user uname (login name or numeric user ID). 


—houser True if the file belongs to a user not in the /etc/passwd database. 


—group gname 
True if the file belongs to group gname (group name or numeric group ID). 


—nogroup True if the file belongs to a group not in the /etc/group database. 
—size n True if the file is n blocks long (512 bytes per block). 

-inum n True if the file has inode number zn. 

~atimen True if the file has been accessed in n days. 

—mtime n True if the file has been modified in n days. 


—exec command | 
True if the executed command returns a zero value as exit status. The end of the command 
must be punctuated by an escaped semicolon. A command argument ‘{}’ is replaced by the 
current ee 


—ok command 
Like —exec except that the generated command is written on the standard output, then the stan- 
dard input is read and the command executed only upon response y. 


—print Always true; causes the current pathname to be printed. 
—Is Always true; causes current pathname to be printed together with its associated statistics. 
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These include (respectively) inode number, size in kilobytes (1024 bytes), protection mode, 
number of hard links, user, group, size in bytes, and modification time. If the file is a special 
file the size field will instead contain the major and minor device numbers. If the file is a sym- 
bolic link the pathname of the linked-to file is printed preceded by ‘‘->’’. The format is identi- 
cal to that of “‘Is -gilds’’ (note however that formatting is done internally, without executing 
the ls program). 
—newer file 
True if the current file has been modified more recently than the argument file. 
—cpio file Write the current file on the argument file in cpio format. 
~—xdev Always true; causes find not to traverse down into a file system different from the one on 
which current argument pathname resides. 
The primaries may be combined using the following operators (in order of aeueiiing ee 
1) A parenthesized group of primaries and operators (parentheses are special to the Shell and must be 
escaped). 
2) The negation of a primary (‘!’ is the unary not operator). 
3) Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries). 
4)  Alternation of primaries (‘—o’ is the or operator). 
EXAMPLES 
To find all accessible files whose pathname contains ‘find’: 
find find | 
To typeset all variants of manual pages for ‘ls’: 
vtroff -man ‘find ’*man*/ls.?’‘ 
To remove all files named ‘a.out’ or ‘*.0’ that have not been accessed for a week: 
find / \( —name a.out —o —name ’*.0’ \) —atime +7 —exec rm {} \; 
FILES 
/etc/passwd 
/etc/group 
/usr/lib/find/find.codes coded pathnames database 
SEE ALSO 
sh(1), test(1), fs(5) 
Relevant paper in February, 1983 issue of ;login:. 
BUGS 
The first form’s syntax is painful, and the second form’s exact semantics is confusing and can vary from 
site to site. 


More than one ‘-newer’ option does not work properly. 
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NAME 


finger — user information lookup program 


SYNOPSIS 


finger [ options } name ... 


DESCRIPTION 


FILES 


By default finger lists the login name, full name, terminal name and write status (as a ‘*’ before the termi- - 
nal name if write permission is denied), idle time, login time, and office location and phone number (if they 
are known) for each current UNIX user. (Idle time is minutes if it is a single integer, hours and minutes if 
a’:’ is present, or days and hours if a ’d’ is present.) 

A longer format also exists and is used by finger whenever a list of people’s names is given. (Account 
names as well as first and last names of users are accepted.) This format is multi-line, and includes all the 
information described above as well as the following: user’s home directory and login shell; any plan 
which the person has placed in the file .plan in his or her home directory; and the project on which the user 
is working, from the file project also in the home directory. 


The letter f is a valid abbreviation for this longer version of finger. 


-1 Forces long output format. 

—m Matches arguments only on user name. 
—p Suppresses printing of the .plan files 
—S Forces short output format. 


/etc/utmp who file 

/etc/passwd for users names, offices, ... 
/usr/adm/lastlog last login times 

“/.plan plans 

“/.project projects 


SEE ALSO 


BUGS 


chfn(1), w(1), who(1) 


Only the first line of the .project file is printed. 


The encoding of the gcos field is UCB dependent — it knows that an office ‘197MC’ is ‘197M Cory Hall’, 
and that ‘S29BE’ is ‘529B Evans Hall’. It also knows that a four digit office phone number should have a 
**x2-’ prepended. 

There is no way to pass arguments to the remote machine as finger uses an internet standard port. 


A user information data base is in the works and will radically alter the way the information that finger 
uses is stored. Finger will require extensive modification when this is implemented. 
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NAME 
fmt — simple text formatter 
SYNOPSIS 
fmt [ file ... ] 
DESCRIPTION 
Fmt is a simple text formatter that reads a concatenation of input files and reformats the files so that each 
line of text is apprcximately 72 characters long. Fmt outputs the reformatted files to the standard output. If 
input files are specified, fmt reads from the standard input. The spacing at the beginning of the input lines 
is preserved in the output, as are blank lines and interword spacing. 
Fmt is meant to format mail messages prior to sending, but may also be useful for other simple tasks. For 
instance, within visual mode of the ex editor (e.g. vi) the command 
!}fmt 
will reformat a paragraph, evening the lines. 
SEE ALSO 
nroff(1), mail(1) 
BUGS 


The program was designed for simplicity and speed. For more complex operations, the standard text pro- 
cessors are likely to be more appropriate. 
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NAME 
fold — fold long lines for finite width output device 


SYNOPSIS 
| fold [—width ] [file ...] 


DESCRIPTION : | 
Fold is a filter that folds the contents of the specified files, breaking the lines to have maximum width 
width. The default for width is 80. Width should be a multiple of 8 if tabs are present, or the tabs should be 
expanded using expand(1) before using fold. If no files are specified, fold filters the contents of the stan- 
dard input. . 


SEE ALSO 
expand(1) 


BUGS 
Fold will sometimes foul up underlining. 
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NAME 
fp — Functional Programming language compiler/interpreter 
SYNOPSIS 
fp 
DESCRIPTION 


Fp is an interpreter/compiler that implements the applicative language proposed by John Backus. It is writ- 
ten in FRANZ LISP. 


In a functional programming language intent is expressed in a mathematical style devoid of assignment 
statements and variables. Functions compute by value only; there are no side-effects since the result of a 
computation depends solely on the inputs. 


Fp “programs” consist of functional expressions — primitive and user-defined fp functions combined by 
functional forms. These forms take functional arguments and return functional results. For example, the 
composition operator '@’ takes two functional argumeats and returns a function which represents their 
composition. 


There exists a single operation in fp — application. This operation causes the system to evaluate the indi- 
cated function using the single argument as input (all functions are monadic). 


GETTING STARTED 


Fp invokes the system. Fp compiles functions into lisp(1) source code; lisp(1) interprets this code (the user 
may compile this code using the liszt (1) compiler to gain a factor of 10 in performance). Control D exits 
back to the shell. Break terminates any computation in progress and resets any open file units. aed. pro- 
vides a short summary of all user commands. 


FILES 
/usr/ucb/lisp the FRANZ LISP interpreter 
/usr/ucb/liszt the liszt compiler 
/ust/doc/fp the User’s Guide 
SEE ALSO 
lisp(1), liszt(1). 
The Berkeley FP user's manual, available on-line. The language is described in the August 1978 issue of 
CACM (Turing award lecture by John Backus). 
BUGS 


If a non-terminating function is applied as the result of loading a file, fp returns control to the user immedi- 
ately and ignores everything after that position in the file. 


Fp incorrectly marks the location of a syntax error on large, multi-line function definitions or applications. 
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NAME 
fpr — print Fortran file 
SYNOPSIS 
fpr 
DESCRIPTION 
Fpr is a filter that transforms files formatted according to Fortran’s carriage control conventions into files 
formatted according to UNIX line printer conventions. 
Fpr copies its input onto its output, replacing the carriage control characters with characters that will pro- 
duce the intended effects when printed using Ipr(1). The first character of each line determines the vertical 
spacing as follows: 
Vertical Space Before Printing 
Blank One line 
Two lines 
To first line of next page 
No advance 
A blank line is treated as if its first character is a blank. A blank that appears as a carriage control character 
is deleted. A zero is changed to a newline. A one is changed to a form feed. The effects of a"+" are simu- 
lated using backspaces. . 
EXAMPLES 
a.out | fpr | Ipr 
fpr < f77.output | pr 
BUGS 


Results are undefined for input lines longer than 170 characters. 
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NAME 

from — who is my mail from? 
SYNOPSIS 

from [ option } [ user ] 
DESCRIPTION 

From prints out the mail header lines in your mailbox file to show you whom your mail is from. If a user 

is specified, then from examines that user’s mailbox instead of your own. 
OPTIONS 

—S sender 

From prints only the headers of mail sent by the specified sender. 

FILES 

/usr/spool/mail/* 
SEE ALSO 

biff(i), mail(1) 
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NAME 


fsplit — split a multi-routine Fortran file into individual files 


SYNOPSIS 


fsplit [ option } ... [ file] 


DESCRIPTION 


Fsplit takes as input either a file or standard input containing Fortran source code. It attempts to split the 
input into separate routine files of the form name.f, where name is the name of the program unit (e.g. func- 
tion, subroutine, block data or program). The name for unnamed block data subprograms has the form 
blkdtaNNNf where NNN is three digits and a file of this name does not already exist. For unnamed main 
programs the name has the form mainNNN,f. If there is an error in classifying a program unit, or if name f 
already exists, the program unit will be put in a file of the form zzzNNN,f where 2zzNNN,f does not already 
exist. 


Normally each subprogram unit is split into a separate file. 


OPTIONS 


-eefile splits only the specified subprogram units are into separate files. E.g.: 
fsplit -e readit -e doit prog.f 
splits readit and doit into separate files. In this example, fsplit does not split the other subprogram 
units. 


DIAGNOSTICS 


BUGS 


If fsplit can not find the subprogram units specified with -e option, it writes a diagnostic to standard error. 


Fsplit assumes the subprogram name is on the first noncomment line of the subprogram unit. Nonstandard 
source formats may confuse fsplit. 


It is hard to use -e for unnamed main programs and block data subprograms since you must predict the 
created filename. 
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NAME 


ftp - ARPANET file transfer program 


SYNOPSIS 


ftp [ options } [ host] 


DESCRIPTION 


Ftp is the user interface to the ARPANET standard File Transfer Protocol. The program allows a user to 
transfer files to and from a remote network site. 


The client host with which ftp is to communicate may be specified on the command line. If this is done, 
ftp will immediately attempt to establish a connection to an FTP server on that host; otherwise, ftp will 
enter its command interpreter and await instructions from the user. When ftp is awaiting commands from 
the user the prompt “‘ftp>’’ is provided to the user. The following commands are recognized by ftp: 


! [ command [ args} 
Invoke an interactive shell on the local machine. If there are arguments, the first is taken to be a 
command to execute directly, with the rest of the arguments as its arguments. 


$ macro-name [{ args ] 
Execute the macro macro-name that was defined with the macdef command. Arguments are 
passed to the macro unglobbed. 


account [ passwd } 
Supply a supplemental password required by a remote system for access to resources once a login 
has been successfully completed. If no argument is included, the user will be prompted for an 
account password in a non-echoing input mode. 


append local-file [ remote-file ] 
Append a local file to a file on the remote machine. If remote-file is left unspecified, the local 
filename is used in naming the remote file after being altered by any nirans or nmap setting. File 
transfer uses the current settings for type, format, mode, and structure . 


ascii Set the file transfer type to network ASCII. This is the default type. 
bell Arrange that a bell be sounded after each file transfer command is completed. 
binary Set the file transfer type to support binary image transfer. 


bye Terminate the FTP session with the remote server and exit ftp. An end of file will also terminate 
the session and exit. 


case Toggle remote computer filename case mapping during mget commands. When case is on 
(default is off), remote computer filenames with all letters in upper case are written in the local 
directory with the letters mapped to lower case. 


cd remote-directory 
Change the working directory on the remote machine to remote-directory. 


cdup Change the remote machine working directory to the parent of the current remote machine work- 
ing directory. 

close Terminate the FTP session with the remote server, and return to the command interpreter. Any 
defined macros are erased. 


cr Toggle carriage return stripping during ascii type file retrieval. Records are denoted by a carriage 
return/linefeed sequence during ascii type file transfer. When cr is on (the default), carriage 
returns are stripped from this sequence to conform with the UNIX single linefeed record delimiter. 
Records on non-UNIX remote systems may contain single linefeeds; when an ascii type transfer is 
made, these linefeeds may be distinguished from a record delimiter only when cr is off. 


delete remote-file 
Delete the file remote-file on the remote machine. 
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debug [ debug-value ] 
Toggle debugging mode. If an optional debug-value is specified it is used to set t the debugging 
level. When debugging is on, ftp prints each command sent to the remote machine, preceded by 
the string ‘o> due 


dir [ remote-directory ] [ local-file ] 
Print a listing of the directory contents in the directory, remote-directory, and, optionally, placing 
the output in local-file. If no directory is specified, the current working directory on the remote 
machine is used. If no local file is specified, or local-file is -, output comes to the terminal. 


disconnect 
A synonym for close. 


form format 
Set the file transfer form to format. The default format is ‘‘file’’. 


get remote-file [ local-file] _ 

Retrieve the remote-file and store it on the local machine. If the local filename is not specified, it 
is given the same name it has on the remote machine, subject to alteration by the current case, 
ntrans, and nmap settings. The current settings for type, form, mode, and structure are used 
while transferring the file. 


glob — Toggle filename expansion for mdelete, mget and mput. If globbing is turned off with glob, the 
| filename arguments are taken literally and not expanded. Globbing for mput is done as in csh(1). 
For mdelete and mget, each remote filename is expanded separately on the remote machine and 

the lists are not merged. Expansion of a directory name is likely to be different from expansion of 

the name of an ordinary file: the exact result depends on the foreign operating system and ftp 

server, and can be previewed by doing ‘mls remote-files -’. Note: mget and mput are not meant 

to transfer entire directory subtrees of files. That can be Gone by transferring a tar(1) archive of 


the subtree (in binary mode). 

hash Toggle hash-sign (‘‘#’’) printing for each data block transferred. The size of a data block is 1024 
bytes. 

help [ command } 


Print an informative message about the meaning of command. If no argument is given, ftp prints 
a list of the known commands. 


Iced [ directory ] 
Change the working directory on the local machine. If no directory is specified, the user’s home 
directory is used. 


Is [ remote-directory ] { local-file } 
Print an abbreviated listing of the contents of a directory on the remote machine. If remote- 
directory is left unspecified, the current working directory is used. If no local file is specified, or if 
local-file is -, the output is sent to the terminal. 


macdef macro-name 

Define a macro. Subsequent lines are stored as the macro macro-name; a null line (consecutive 
newline characters in a file or carriage returns from the terminal) terminates macro input mode. 
There is a limit of 16 macros and 4096 total characters in all defined macros. Macros remain 
defined until a close command is executed. The macro processor interprets ’$’ and ’\’ as special 
characters. A ’$’ followed by a number (or numbers) is replaced by the corresponding argument 
on the macro invocation command line. A ’$’ followed by an ’i’ signals that macro processor that 
the executing macro is to be looped. On the first pass ’$i’ is replaced by the first argument on the 
macro invocation command line, on the second pass it is replaced by the second argument, and so 
on. A ’\’ followed by any character is piers by that character. Use the ’\’ to prevent special 
treatment of the ’$’. 
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mdelete [ remote-files ] 
Delete the remote-files on the remote machine. 


mdir remote-files local-file 
Like dir, except multiple remote files may be specified. If interactive prompting is on, ftp will 
prompt the user to verify that the last argument is indeed the target local file for receiving mdir 
output. 


meget remote-files 
Expand the remote-files on the remote machine and do a get for each filename thus produced. See 
glob for details on the filename expansion. Resulting filenames will then be processed according 
to case, ntrans, and nmap settings. Files are transferred into the local working directory, which 
can be changed with ‘led directory’; new local directories can be created with ‘! mkdir directory’. 
mkdir directory-name 
Make a directory on the remote machine. 


mls remote-files local-file 
Like Is, except multiple remote files may be specified. If interactive prompting is on, ftp will 
prompt the user to verify that the last argument is indeed the target local file for receiving mls out- 
put. 


mode [ mode-name ] 
Set the file transfer mode to mode-name. The default mode is ‘‘stream’’ mode. 


mput local-files 
Expand wild cards in the list of local files given as arguments and do a put for each file in the 
resulting list. See glob for details of filename expansion. Resulting filenames will then be pro- 
cessed according to ntrans and nmap settings. 


nmap [ inpattern outpattern | 
Set or unset the filename mapping mechanism. If no arguments are specified, the filename map- 
ping mechanism is unset. If arguments are specified, remote filenames are mapped during mput 
commands and put commands issued without a specified remote target filename. If arguments are 
specified, local filenames are mapped during mget commands and get commands issued without a 
specified local target filename. This command is useful when connecting to a non-UNIX remote 
computer with different file naming conventions or practices. The mapping follows the pattern set 
by inpattern and outpattern. Inpattern is a template for incoming filenames (which may have 
already been processed according to the ntrans and case settings). Variable templating is accom- 
plished by including the sequences ’$1’, ’$2’, ..., $9’ in inpattern. Use ’\’ to prevent this special 
treatment of the ’$’ character. All other characters are treated literally, and are used to determine | 
the nmap inpattern variable values. For exmaple, given inpattern $1.$2 and the remote filename 
“mydata.data”, $1 would have the value "mydata", and $2 would have the value "data". The out- 
pattern determines the resulting mapped filename. The sequences ’$1’, $2’, ...., "$9 are replaced 
by any value resulting from the inpattern template. The sequence ’$0’ is replace by the original 
filename. Additionally, the sequence ’[seq1],seq2]’ is replaced by seq! if seq/ is not a null string; 
otherwise it is replaced by seg2. For example, the command "nmap $1.$2.$3 [$1,$2].[$2,file]" 
would yield the output filename "myfile.data" for input filenames "“myfile.data" and 
“myfile.data.old", “myfile.file" for the input filename "myfile", and “myfile.myfile" for the input 
filename ".myfile". Spaces may be included in outpattern, as in the example: nmap $1 |sed "s/ 
*$//" > $1. Use the ’\’ character to prevent special treatment of the ’$’, ’[’, ’]’, and ’,’ characters. 
ntrans [ inchars [ outchars ] } 

Set or unset the filename character translation mechanism. If no arguments are specified, the 
filename character translation mechanism is unset. If arguments are specified, characters in 
remote filenames are translated during mput commands and put commands issued without a 
specified remote target filename. If arguments are specified, characters in local filenames are 
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translated during mget commands and get commands issued without a specified local target 
filename. This command is useful when connecting to a non-UNIX remote computer with dif- 
ferent file naming conventions or practices. Characters in a filename matching a character in 
inchars are replaced with the corresponding character in outchars. If the character’s position in 
inchars is longer than the length of outchars, the character is deleted from the filename. 


open host [ port } 
Establish a connection to the specified host FTP server. An optional port number may be sup- 
plied, in which case, ftp will attempt to contact an FTP server at that port. If the auto-login option 
is on (default), ftp will also attempt to automatically log the user in to the FTP server (see below). 


prompt Toggle interactive prompting. Interactive prompting occurs during multiple file transfers to allow 
the user to selectively retrieve or store files. If prompting is turned off (default is on), any mget or 
mput will transfer all files, and any mdelete will delete all files. 


proxy fip-command 

Execute an ftp command on a secondary control connection. This command allows simultaneous 
connection to two remote ftp servers for transferring files between the two servers. The first 
proxy command should be an open, to establish the secondary control connection. Enter the com- 
mand "proxy ?" to see other ftp commands executable on the secondary connection. The follow- 
ing commands behave differently when prefaced by proxy: open will not define new macros dur- 
ing the auto-login process, close will not erase existing macro definitions, get and mget transfer 
files from the host on the primary control connection to the host on the secondary control connec- 
tion, and put, mput, and append transfer files from the host on the secondary control connection 
to the host on the primary control connection. Third party file transfers depend upon support of 
the ftp protocol PASV command by the server on the secondary control connection. 


put local-file [ remote-file ] 
Store a local file on the remote machine. If remote-file is left unspecified, the local filename is 
used after processing according to any ntrans or nmap settings in naming the remote file. File 
transfer uses the current settings for type, format, mode, and structure. 


pwd _ Print the name of the current working directory on the remote machine. 
quit | A synonym for bye. 
quote arg] arg... 
_ The arguments specified are sent, verbatim, to the remote FTP server. 
recy remote-file [ local-file ] 
A synonym for get. 
remotehelp [ command-name ] | 
Request help from the remote FTP server. If a command-name is specified it is supplied to the 
server as well. 


rename [ from] [ to] 
Rename the file from on the remote machine, to the file to. 


reset Clear reply queue. This command re-synchronizes command/reply sequencing with the remote 
ftp server. Resynchronization may be neccesary following a violation of the ftp protocol by the 
remote server. 


- rmdir directory-name 
Delete a directory on the remote sighing: 


runique 
Toggle storing of files on the local system with unique filenames. If a file already exists with a 
name equal to the target local filename for a get or mget. command, a ".1" is appended to the 
name. If the resulting name matches another existing file, a".2” is appended to the original name. 
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If this process continues up to ".99", an error message is printed, and the transfer does not take 
place. The generated unique filename will be reported. Note that runique will not affect local 
files generated from a shell command (see below). The default value is off. 


send local-file [ remote-file ] 
A synonym for put. 

sendport 
Toggle the use of PORT commands. By default, ftp will attempt to use a PORT command when 
establishing a connection for each data transfer. The use of PORT commands can prevent delays 
when performing multiple file transfers. If the PORT command fails, ftp will use the default data 
port. When the use of PORT commands is disabled, no attempt will be made to use PORT com- 
mands for each data transfer. This is useful for certain FTP implementations which do ignore 
PORT commands but, incorrectly, indicate they’ve been accepted.. 


status Show the current status of ftp. 


struct [ struct-name ] 
Set the file transfer structure to struct-name. By default ‘‘stream’’ structure is used. 


sunique 
Toggle storing of files on remote machine under unique filenames. Remote ftp server must sup- 
port ftp protocol STOU command for successful completion. The remote server will report 
unique name. Default value is off. 


tenex Set the file transfer type to that needed to talk to TENEX machines. 
trace Toggle packet tracing. 


type [ type-name ] 
Set the file transfer ips to type-name. If no type is oon the current type is printed. The 
default type is network ASCII. 


user user-name [ password ] [ account } 
Identify yourself to the remote FTP server. If the password is not specified and the server requires 
it, ftp will prompt the user for it (after disabling local echo). If an account field is not specified, 
and the FTP server requires it, the user will be prompted for it. If an account field is specified, an 
account command will be relayed to the remote server after the login sequence is completed if the 
remote server did not require it for logging in. Unless ftp is invoked with ‘‘auto-login’’ disabled, 
this process is done automatically on initial connection to the FTP server. 


verbose Toggle verbose mode. In verbose mode, all responses from the FTP server are displayed to the 
user. In addition, if verbose is on, when a file transfer completes, statistics regarding the 
efficiency of the transfer are reported. By default, verbose is on. 


? [command ] 
A synonym for help. 


Command arguments which have embedded spaces may be quoted with quote (") marks. 


ABORTING A FILE TRANSFER 
To abort a file transfer, use the terminal interrupt key (usually Ctrl-C). Sending transfers will be immedi- 
ately halted. Receiving transfers will be halted by sending a ftp protocol ABOR command to the remote 
server, and discarding any further data received. The speed at which this is accomplished depends upon 
the remote server’s support for ABOR processing. If the remote server does not support the ABOR com- 
mand, an "ftp>" prompt will not appear until the remote server has completed sending the requested file. 


The terminal interrupt key sequence will be ignored when ftp has completed any local processing and is 
awaiting a reply from the remote server. A long delay in this mode may result from the ABOR processing 
described above, or from unexpected behavior by the remote server, including violations of the ftp proto- 
col. If the delay results from unexpected remote server behavior, the local ftp program must be killed by 
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FILE NAMING CONVENTIONS 
Files specified as arguments to ftp commands are processed according to the following rules. 


=) 
2) 


3) 


4) 


5) 


If the filename ‘‘—’’ is specified, the stdin (for reading) or stdout (for writing) is used. 


_ If the first character of the filename is ‘‘|’’, the remainder of the argument is interpreted as a shell 


command. Ftp then forks a shell, using popen(3) with the argument supplied, and reads (writes) 
from the stdout (stdin). If the shell command includes spaces, the argument must be quoted; e.g. 
““"! Is -It"’’. A particularly useful example of this mechanism is: ‘‘dir |more’’. 


Failing the above checks, if ‘‘globbing’’ is enabled, local filenames are expanded according to the 
rules used in the csh(1); c.f. the glob command. If the ftp command expects a single local file ( 
e.g. put), only the first filename generated by the "globbing" operation is used. 


For mget commands and get commands with unspecified local filenames, the local filename is the 
remote filename, which may be altered by a case, ntrans, or nmap Setting. The resulting filename 
may then be altered if runique is on. 


For mput commands and put commands with unspecified remote filenames, the remote filename 
is the local filename, which may be altered by a ntrans or nmap setting. The resulting filename 
may then be altered by the remote server if sunique is on. 


FILE TRANSFER PARAMETERS 
The FTP specification specifies many parameters which may affect a file transfer. The type may be one of 
‘ascii’, ‘‘image’’ (binary), ‘‘ebcdic’’, and ‘‘local byte size’’ (for PDP-10’s and PDP-20’s mostly). Ftp 
supports the ascii and image types of file transfer, plus local byte size 8 for tenex mode transfers. 


Ftp supports only the default values for the remaining file transfer parameters: mode, form, and struct. 


OPTIONS 


Options may be specified at the command line, or to the command interpreter. 


—d 
—8 
-i 


—-v 


THE .netre FILE 


Enables debugging. 
Disables filename globbing. 
Turns off interactive prompting during multiple file transfers. 


Restrains ftp from attempting ‘‘auto-login’’ upon initial connection. If auto-login is enabled, ftp 
will check the .netrc (see below) file in the user’s home directory for an entry describing an 
account on the remote machine. If no entry exists, ftp will prompt for the remote machine login 
name (default is the user identity on the local machine), and, if necessary, prompt for a password 
and an account with which to login. 


(Verbose on) forces ftp to show all responses from the remote server, as well as report on data 
transfer statistics. 


The .netrc file contains login and initialization information used by the auto-login process. It resides in the 
user's home directory. The following tokens are recognized; they may be separated by spaces, tabs, or 
new-lines: . 


machine name 


Identify a remote machine name. The auto-login process searches the .netrc file for a machine 
token that matches the remote machine specified on the ftp command line or as an open command 
argument. Once a match is made, the subsequent .netrc tokens are processed, stopping when the 


end of file is s reached « or another machine token is encountered. 


login name 
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password string 
Supply a password. If this token is present, the auto-login process will supply the specified string 
if the remote server requires a password as part of the login process. Note that if this token is 
present in the .netrc file, ftp will abort the auto-login process if the .netrc is readable by anyone 
besides the user. 


account string 
Supply an additional account password. If this token is present, the auto-login process will supply 
the specified string if the remote server requires an additional account password, or the auto-login 
process will initiate an ACCT command if it does not. 


macdef name 
Define a macro. This token functions like the ftp macdef command functions. A macro is 
defined with the specified name; its contents begin with the next .netrc line and continue until a 
null line (consecutive new-line characters) is encountered. If a macro named init is defined, it is 
automatically executed as the last step in the auto-login process. 


BUGS 
Correct execution of many commands depends upon proper behavior by the remote server. 


An error in the treatment of carriage returns in the 4.2BSD UNIX ascii-mode transfer code has been 
corrected. This correction may result in incorrect transfers of binary files to and from 4.2BSD servers 
using the ascii type. Avoid this problem by using the binary image type. 
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NAME 
gcore — get core images of running processes 
SYNOPSIS 
gcore process-id ... 
DESCRIPTION 
Gcore creates a core image of each specified process, suitable for use with adb(1) or dbx(1). 
FILES ; 
core.<process-id> core images 
BUGS 


Paging activity that occurs while gcore is running may cause the program to become confused. For best 
results, the desired processes should be stopped. 
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NAME 


gprof — display call graph profile data 


SYNOPSIS 


gprof [ options ] [ a.out [ gmon.out ...}] 


DESCRIPTION 


Gprof produces an execution profile of C, Pascal, or Fortran77 programs. The effect of called routines is 
incorporated in the profile of each caller. The profile data is taken from the call graph profile file 
(gmon.out by default) which is created by programs which are compiled with the —pg option of cc, pc, and 
77. That option also links in versions of the library routines which are compiled for profiling. The symbol 
table in the named object file (a.out default) is read and correlated with the call graph profile file. If more 
than one profile file is specified, the gprof output shows the sum of the profile information in the given 
profile files. 


First, a flat profile is given, similar to that provided by prof(1). This listing gives the total execution times 
and call counts for each of the functions in the program, sorted by decreasing time. 


Next, these times are propagated along the edges of the call graph. Cycles are discovered, and calls into a 
cycle are made to share the time of the cycle. A second listing shows the functions sorted according to the 
time they represent including the time of their call graph descendents. Below each function entry is shown 
its (direct) call graph children, and how their times are propagated to this function. A similar display above 
the function shows how this function’s time and the time of its descendents is propagated to its (direct) call 
graph parents. 


Cycles are also shown, with an entry for the cycle as a whole and a listing of the members of the cycle and 
their contributions to the time and call counts of the cycle. 


OPTIONS 


—a Suppresses the printing of statically declared functions. If this option is given, all relevant infor- 
mation about the static function (e.g., time samples, calls to other functions, calls from other func- 
tions) belongs to the function loaded just before the static function in the a.out file. 


—b Supresses the printing of a description of each field in the profile. 


—C Discovers the static call graph of the program by means of a heuristic which examines the text 
space of the object file. Static-only parents or children are indicated with call counts of 0. 


—e name 
Suppresses the printing of the graph profile entry for routine name and all its descendants (unless 
they have other ancestors that aren’t suppressed). More than one —e option may be given. Only 
one name may be given with each —e option. 


—E name 
Suppresses the printing of the graph profile entry for routine name (and its descendants) as —e, 
above, and also excludes the time spent in name (and its descendants) from the total and percen- 
tage time computations. (For example, -E mcount —E mcleanup is the default.) 


—f name 
Prints the graph profile entry of only the specified routine name and its descendants. More than 
one —f option may be given. Only one name may be given with each —f option. 


Prints the graph profile entry of only the routine name and its descendants (as —f, above) and also 
uses only the times of the printed routines in total time and percentage computations. More than 
one —F option may be given. Only one name may be given with each —F option. The —F option 
overrides the —E option. 


—S Produces a profile file gmon.sum. The file represents the sum of the profile information in all the 
specified profile files. This summary profile file may be given to subsequent executions of gprof 
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(probably also with a —s) to accumulate profile data across several runs of an a.out file. 


—Z displays routines which have zero usage (as indicated by call counts and accumulated time). This 
is useful in conjunction with the —c option for discovering which routines were never called. 


FILES 
®the namelist and text space. 
®dynamic call graph and profile. 
' ®summarized dynamic call graph and profile. 
SEE ALSO 
monitor(3), profil(2), cc(1), prof(1) 


*‘gprof: A Call Graph Execution Profiler’, by Graham, S.L., Kessler, P.B., McKusick, M.K.; Proceedings 
of the SIGPLAN '82 Symposium on Compiler Construction, SIGPLAN Notices, Vol. 17, No. 6, pp. 120- 
126, June 1982. 
BUGS 

Beware of quantization errors. The granularity of the sampling is shown, but remains statistical at best. 
We assume that the time for each execution of a function can be expressed by the total time for the func- 
tion divided by the number of times the function is called. Thus the time propagated along the call graph 
arcs to parents of that function is directly proportional to the number of times that arc is traversed. 


Parents which are not themselves profiled will have the time of their profiled children propagated to them, 
but they will appear to be spontaneously invoked in the call graph listing, and will not have their time pro- 
pagated further. Similarly, signal catchers, even though profiled, will appear to be spontaneous (although 
for more obscure reasons). Any profiled children of signal catchers should have their times propagated 
properly, unless the signal catcher was invoked during the execution of the profiling routine, in which case 
all is lost. 


The profiled program must t call exit(2) or return normally for the profiling information to be saved in the 
gmon.out file. 
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graph — draw a graph 


SYNOPSIS 


graph [ options | 


DESCRIPTION 


Graph with no options takes pairs of numbers from the standard input as abscissas and ordinates of a 
graph. Successive points are connected by straight lines. The graph is encoded on the standard output for 
display by the plot(1G) filters. 


If the coordinates of a point are followed by a nonnumeric string, that string is printed as a label beginning 
on the point. Labels may be surrounded with quotes "...", in which case they may be empty or contain 
blanks and numbers. Labels should never contain newlines. . 


OPTIONS 


Graph recognizes the following options, each as a separate argument. 


-—x [1] 


-y{1] 


Supply abscissas automatically (they are missing from the input); spacing is given by the next 
argument (default 1). A second optional argument is the starting point for automatic abscissas 
(default 0 or lower limit given by —x). 


Break (disconnect) the graph after each label in the input. 

Character string given by next argument is default label for each point. 

Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid (default). 
Next argument is label for graph. 


Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected (default). Some 
devices give distinguishable line styles for other small integers. 


Save screen: don’t erase before plotting. 

Next argument is fraction of space for height. 

Next argument is fraction of space for width. 

Next argument is fraction of space to move right before plotting. 

Next argument is fraction of space to move up before plotting. 

Transpose horizontal and vertical axes. (Option —x now applies to the vertical axis.) 


If ] is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x limits. Third 
argument, if present, is grid spacing on x axis. Normally these quantities are determined automati- 
cally. 

If lis present, y axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) y limits. Third 
argument, if present, is grid spacing on y axis. Normally these quantities are determined automati- 
Cally. . 


Without the —s option, graph produces a legend indicating grid range. 


If a specified lower limit exceeds the upper limit, graph reverses the axis. 


SEE ALSO 


spline(1G), plot(1G) 


BUGS 


Graph stores all points internally and drops those for which there isn’t room. 
Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 
grep, egrep, fgrep — search a file for a pattern 
SYNOPSIS : 
grep [ options ] expression [ files } 
egrep [ options ] [ expression } [ files ] 
fgrep [ options } [ strings} [file ] 
DESCRIPTION ; 
Commands of the grep family search the input files (standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard output. Grep patterns are limited regular expressions 
in the style of ex(1); it uses a compact nondeterministic algorithm. Egrep patterns are full regular expres- 


sions; it uses a fast deterministic algorithm that sometimes needs exponential space. Fgrep patterns are 
fixed strings; it is fast and compact. 


In all cases the filename is shown if there is more than one input file. Care should be taken when using the 
characters $ * [* | ( ) and \ in the expression as they are also meaningful to the Shell. It is safest to enclose 
the entire expression argument in single quotes “ °. 


Fgrep searches for lines that contain one of the (newline-separated) strings. 
Egrep accepts extended regular expressions. In the following description ‘character’ excludes newline: 
A \ followed by a single character other than newline matches that character. 
The character “ matches the beginning of a line. 
The character $ matches the end of a line. 
A . (period) matches any character. 
A single character not otherwise endowed with special meaning matches that character. 


A String enclosed in brackets [] matches any single character from the string. Ranges of ASCII 
character codes may be abbreviated as in ‘a-z0-9’. A ] may occur only as the first character of 
the string. A literal — must be placed where it can’t be mistaken as a range indicator. 

A regular expression followed by an * (asterisk) matches a sequence of 0 or more matches of the 
regular expression. A regular expression followed by a + (plus) matches a sequence of 1 or more 
matches of the regular expression. A regular expression followed by a ? (question mark) matches _ 
a sequence of 0 or 1 matches of the regular expression. 


Two regular expressions concatenated match a match of the first followed by a match of the 
second. : 


Two regular expressions separated by | or newline match either a match for the first or a match for 
the second. 


A regular expression enclosed in parentheses matches a match for the regular expression. 


The order of precedence of operators at the same parenthesis level is [] then *+? then concatenation then | 
and newline. 


Ideally there should be only one grep, but there has not yet been developed a single algorithm that spans a 
wide enough range of space-time tradeoffs. 


OPTIONS 
—b Each line is preceded by the block number on which it was found. This is sometimes useful in 
locating disk block numbers by context. 


—¢c Only a count of matching lines is printed. 


—e expression . 
Same as a simple expression argument, but useful when the expression begins with a —. 
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The regular expression (egrep ) or string list (fgrep) is taken from the file. 


The case of letters is ignored in making comparisons — that is, upper and lower case are con- 
sidered identical. This applies to grep and fgrep only. 


The names of files with matching lines are listed (once) separated by newlines. 
Each line is preceded by its relative line number in the file. 


Silent mode. Nothing is printed (except error messages). This is useful for checking the error 
Status. 


All lines but those matching are printed. 


The expression is searched for as a word (as if surrounded by ‘\<’ and ‘\>’, see ex(1).) (grep 
only) 


(Exact) only lines matched in their entirety are printed (fgrep only). 


ex(1), sed(1), sh(1) 


DIAGNOSTICS 


Exit status is 0 if any matches are found, 1 if no matches are found, or 2 for syntax errors or inaccessible 


files. 
BUGS 


Grep, egrep, and fgreptruncate lines longer than 256 characters. 
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NAME | | 

groups — show group memberships 

SYNOPSIS 
groups [ user ] 

DESCRIPTION 
The groups command shows the groups to which you or the specified user belong. Each user belongs to a 
group specified in the password file /etc/passwd. A user may also belong to other groups, as specified in 
the file /etc/group. If you do not own a particular file but do belong to the group that owns it, you are 
granted group access to the file. 
When a new file is created, it is given the group of the containing directory. 

_ SEE ALSO 
setgroups(2) 

FILES 
/etc/passwd, /etc/group 

BUGS 
More groups should be allowed. 
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NAME 
head — give first few lines 


SYNOPSIS 
head [ —count } [file ...] 

DESCRIPTION 
This filter gives the first count lines of each of the specified files, or of the standard input. If you do not 
specify a count, it defaults to 10. 


SEE ALSO 
tail(1) 
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NAME 
hostid — set or print identifier of current host system 


SYNOPSIS 
hostid [ identifier ] 

DESCRIPTION © 
The hostid command prints the identifier of the current host in hexadecimal. This numeric value is 
expected to be unique across all hosts and is commonly set to the host’s Internet address. The super-user 
can set the hostid by giving a hexadecimal pea or the hostname; this is usually done in the startup 
script /etc/rc.local. 


SEE ALSO 
gethostid(2), sethostid(2) 
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NAME 
hostname ~ set or print name of current host system 

SYNOPSIS 
hostname [ nameofhost ] 

DESCRIPTION 
The hostname command prints the name of the current host, as given before the ‘‘login’’ prompt. The 
super-user can set the hostname by giving an argument; this is usually done in the startup script 
/etc/rc.local. 

SEE ALSO 
gethostname(2), sethostname(2) 
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indent — indent and format C program source 


SYNOPSIS 


indent input-file [ output-file } [ options ] 


DESCRIPTION 


Indent is a C program formatter that reformats the C program in the input-file according to the switches. 
The OPTIONS section below describes the switches. They may si before or after the filenames on the 


command line. 


NOTE: If you only specify an input-file, the formatting is done ‘in-place’, that is, the formatted file is writ- 
ten back into input-file and a backup copy of input-file is written in the current directory. If input-file is 
named ‘/blah/blah/file’, the backup file is named file BAK. 


If you do specify an output-file, indent checks to make sure it is not the input-file. 


OPTIONS 


The options listed below control the formatting style imposed by indent.Optionsthatbeginwith options. 


—bad,—nbad 

—bap,—nbap 
| —bbb,—nbbb 

—be,—nbc 


—br,—bl 


—cdn 


~—cdb,—ncdb 
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Forces a blank line after every block of declarations. —nbad does not force a blank line. 
Default: —nbad. 


Forces a blank line after every procedure body. Seay does not force a blank line. 
Default: —nbap. 


Forces a blank line before every block comment. —nbbb does not force a blank line. 
Default: —nbbb. 


Forces a newline after each comma in a declaration. -nbc turns this option off. The 
default is —nbc. 


Specifying —bl lines up compound statements like this: 


if (...) 
{ 
code 


} 


Specifying —br (the default) makes them look like this: 


if (...) { 
code 
} 
Sets the column in which comments on code start. The default is 33. 


Sets the column in which comments on declarations start. By default, these comments 
start in the same column as those on code. 


Enables (—ncdb disables) the placement of comment delimiters on blank lines. With 
this option enabled, comments look like this: 


/* 
* this is a comment 
*/ 


Rather than like this: 


INTEGRATED SOLUTIONS 4.3 BSD . : 1 


INDENT (1) 


~—ce,—nce 


—cin 


—clin 


—din 
—dj,—ndj 
—ei,—nei 
—fcl,—nfcl 
—in 
—ip,—nip 


—ln 
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/* this is a comment */ 


This only affects block comments, not comments to the right of code. The default is 
—cdb. . 


Enables (—nce disables) forcing ‘else’s to cuddle up to the immediately preceding ‘}’. 
The default is —ce. 


Sets the continuation indent to be n. Continuation lines will be indented that far from 
the beginning of the first line of the statement. Parenthesized expressions have extra 
indentation added to indicate the nesting, unless —Ip is in effect. —ci defaults to the same 
value as —i. 

Causes case labels to be indented n tab stops to the right of the containing switch state- 
ment. —cli0.5 causes case labels to be indented half a tab stop. The default is —cli0. 
(This is the only option that takes a fractional argument.) 


Controls the placement of comments which are not to the right of code. Specifying —d1 
places such comments one indentation level to the left of code. The default —d0 lines up 
these comments with the code. See the section on comment indentation below. 


Specifies the indentation, in character positions, from a declaration keyword to the fol- 
lowing identifier. The default is —dil6. 

—dj left justifies declarations. —ndj indents declarations the same as code. The default 
is —ndj. 

Enables (—nei disables) special else-if processing. If enabled, ifs following elses will 
have the same indentation as the preceding if statement. The default is —ei. 


Enables (—nfcl1 disables) the formatting of comments that start in column 1. Often, 
comments whose leading ‘/’ is in column 1 have been carefully hand formatted by the 
programmer. In such cases, —nfcl should be used. The default is fel. 


Sets the number of spaces for one indentation level. The default is 8. 


Enables (—nip disables) the indentation of parameter declarations from the left margin. 
The default is —ip. 
Sets the maximum length of an output line. The default is 78. 


Lines up code surrounded by parenthesis in continuation lines. If a line has a left paren 
which is not closed on that line, then continuation lines will be lined up to start at the 
Character position just after the left paren. For example, here is how a piece of contin- 
ued code looks with —nlp in effect: 


pi = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 


With —lp in effect (the default) the code looks somewhat clearer: 


pl = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 


Inserting two more newlines we get: 
pl = first_procedure(second_procedure(p2, 
| p3), 


third_procedure(p4, 
p5)); 
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—npro Causes the profile files, ‘/.indent.pro’ and ‘7/. indent .pro’, to be ignored. 


—pcs,—npcs If true (—pcs) all procedure calls will have a space inserted between the name and the 
‘(. The default is —npes. 


—ps,—nps If true (—ps) the pointer following operator ‘—>’ will be surrounded by spaces on either 
side. The default is —nps. 
—psl,—npsl __ If true (—psl) the names of procedures being defined are placed in column 1 — their 
types, if any, will be left on the previous lines. The default is —psl. 
—SC,—NSC Enables (—msc disables) the placement of asterisks (‘*’s) at the left edge of all com- 


ments. The default is —sc. 


—sob,—nsob Swallows optional blank lines. You can use —sob to get rid of blank lines after declara- 
tions. —nsob turns this option off. Default: —nsob. 


—st Causes indent to take its input from stdin, and put its output to stdout. 


—Ttypename Adds typename to the list of type keywords. Names accumulate: —T can be specified 
more than once. You need to specify all the typenames that appear in your program that 
are defined by typedefs — nothing will be harmed if you miss a few, but the program 
won’t be formatted as nicely as it should. This sounds like a painful thing to have to do, 
but it’s really a symptom of a problem in C: typedef causes a syntactic change in the 
language and indent can’t find all typedefs. 


—troff Causes indent to format the program for processing by troff. It will produce a fancy 
listing in much the same spirit as vgrind. If the output file is not arenes the default is 
standard output, rather than formatting in place. 


—V,—-lv —v turns on ‘verbose’ mode; —nv turns it off. When in verbose mode, indent reports 
when it splits one line of input into two or more lines of output, and gives some size 
Statistics at completion. The default is —nv. 


FURTHER DESCRIPTION 
You may set up your own ‘profile’ of defaults to indent by creating a file called indent pro in either your 
login directory and/or the current directory and including whatever switches you like. Switches in 
‘.indent.pro’ in the current directory override those in your login directory (with the exception of -T type 
. definitions, which just accumulate). If indent is run and a profile file exists, then it is read to set up the 
program’s defaults. The switches should be separated by spaces, tabs or newlines. Switches on the com- 
mand line, however, override profile switches. 


Comments 


‘Box’ comments. Indent assumes that any comment with a dash or star immediately after the start of com- 
ment (that is, ‘/*—’ or ‘/**’) is a comment surrounded by a box of stars. Each line of such a comment is 
left unchanged, except that its indentation may be adjusted to account for the change in indentation of the 
first line of the comment. 


Straight text. All other comments are treated as straight text. Indent fits as many words (separated by 
blanks, tabs, or newlines) on a line as eeu Blank lines break paragraphs. 


Comment indentation 


_ If acomment is on a line with code it is started in the ‘comment column’, which is set by the —-cn command 
line parameter. Otherwise, the comment is started at n indentation levels less than where code is currently 
being placed, where n is specified by the —-dz command line parameter. If the code on a line extends past 
the comment column, the comment starts further to the right, and the right margin may be pen 
extended in extreme cases. 
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Preprocessor lines 

In general, indent leaves preprocessor lines alone. The only reformatting that it will do is to straighten up 
trailing comments. It leaves embedded comments alone. Conditional compilation (#ifdef...#endif) is 
recognized and indent attempts to correctly compensate for the syntactic peculiarities introduced. 

C syntax 


Indent understands a substantial amount about the syntax of C, but it has a ‘forgiving’ parser. It attempts 
to cope with the usual sorts of incomplete and misformed syntax. In particular, the use of macros like: 
#define forever for(;;) 


is handled properly. 
FILES 
/ indent.pro profile file 
“/.indent.pro profile file 
BUGS 


Indent has even more switches than bs. 
A common mistake that causes grief is typing: 
indent *.c 


to the shell in an attempt to indent all the C programs in a directory. 
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NAME 
install — install binaries 

SYNOPSIS 
install [ options ] binary destination 

DESCRIPTION 
Install moves binary (or copies it if you specified —c) to destination. If destination already exists, it is 
removed before binary is moved. If the destination is a directory then binary is moved into the destination 
directory with its original filename. 
Install refuses to move a file onto itself. 


By default, install sets the destination’s mode to 755, its owner to root, and its group to staff. You can use 
the options described below to change these settings. 


OPTIONS 
—¢ Copes binary to destination instead of moving it. 


—Z group 
Sets the group for destination to group. The default is staff. 


—m mode 
Sets the mode for destination to mode. The default is 755. 


—0O owner 
Sets the owner of destination to owner. The default is root. 


-s Strips the binary after installing it. 


SEE ALSO 
chgrp(1), chmod(1), cp(1), mv(1), strip(1), chown(8) 
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NAME 

iostat — report I/O statistics 
SYNOPSIS 

jostat [ drives ] [ interval [ count }] 


DESCRIPTION 

Iostat iteratively reports the number of characters read and written to terminals per second, and, for each 
disk, the number of transfers per second, kilobytes transferred per second, and the milliseconds per average 
seek. It also gives the percentage of time the system has spent in user mode, in user mode running low 
priority (niced) processes, in system mode, and idling. 

To compute this information, for each disk, seeks and data transfer completions and number of words 
transferred are counted; for terminals collectively, the number of input and output characters are counted. 
Also, each sixtieth of a second, the state of each disk is examined and a tally is made if the disk is active. 
From these numbers and given the transfer rates of the devices it is possible to determine average seek 
times for each device. 


If more than 4 disk drives are configured in the system, iostat displays only the first 4 drives. To force ios- 
tat to display specific drives, specify the drive names on the command line. 


OPTIONS | 
interval Causes iostat to report once each interval seconds. The first report is for all time since a reboot 
and each subsequent report is for the last interval only. 
count Restricts the number of reports. 
FILES 
_ /dev/kmem 
/vmunix 


SEE ALSO 
vmstat(1) 
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NAME 
join — relational database operator 


SYNOPSIS 
join [ options ] filel file2 
DESCRIPTION 


Join vals on the standard output, a join of the two relations specified by the lines of file] and file2. If 
filel is ‘—’, the standard input is used. 


Filel and file2 must be sorted in increasing ASCII ane sequence on the fields on which they are to be 
joined, normally the first field in each line. 


There is one line in the output for each pair of lines in file] and file2 that have identical join fields. The 
output line normally consists of the common eae the rest of the line from file! , and the rest of the line 
from file2. 


Fields are normally separated by a blank, a tab, or a newline. In these cases, join interprets multiple 
separators as a single separator and discards the leading separators. 


OPTIONS 
—an In addition to the normal output, produces a line for each unpairable line in file 2, where n is 1 or 
2. . 


—es Replaces empty output fields by string s. 
—jnm Joins on the mth field of file n. If n is missing, uses the mth field in each file. 


—o list Each output line comprises the fields specified in list, each element of which has the form 1.m, 
where nv is a file number and m is a field number. 


—tc Uses character c as a separator (tab character). Every appearance of c in a line is significant. 


SEE ALSO 
sort(1), comm(1), awk(1) 


BUGS 
With default field separation, the collating sequence is that of sort —b; with —t, the sequence is that of a 
plain sort. 


The conventions of join, sort, comm, uniq, look and awk(1) are wildly incongruous. 
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NAME 
kill — terminate a process with extreme prejudice 

SYNOPSIS 
kill [ —signal ] processid ... 
kill -1 

DESCRIPTION 
Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or number pre- 
ceded by ‘—’ is given as first argument, that signal is sent instead of terminate (see sigvec(2)). The signal 
names are listed by ‘kill -I’, and are as given in /usr/include/signal.h, but stripped of the common SIG 
prefix. 
The terminate signal will kill processes that do not catch the signal; ‘kill —9 ...’ is a sure kill, as the KILL 
(9) signal cannot be caught. By convention, if process number 0 is specified, all members in the process 
group (i.e. processes resulting from the current login) are signaled. (Note that this works only with sh(1), 
not with csh(1).) Negative process numbers also have special meanings; see kill(2) for details. 
The killed processes must belong to the current user unless he or she is the super-user. 


The process number of an asynchronous process started with ‘&’ is reported by the shell. Process numbers 
can also be found by using ps(1). 


Kill is a built-in to csh(1). It allows job specifiers of the form ‘‘%...’’ as arguments so process id’s are not 
as often used as kill arguments. See csh(1) for details. 


SEE ALSO 
csh(1), ps(1), kill(2), sigvec(2) 
BUGS | 
A replacement for ‘‘kill 0’’ for csh(1) users should be provided. _ 
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NAME 
last — indicate last logins of users and teletypes 

SYNOPSIS 
last [ option } [ rlame ...] [ tty...] 

DESCRIPTION i 7 
Last reads from the wtmp file records all logins and logouts for information about a user, a teletype, or any 
group of users and teletypes. Arguments specify names of users or teletypes of interest. Names of tele- 
types may be given fully or abbreviated. For example ‘last 0’ is the same as ‘last tty0’. If multiple argu- 
ments are given, the information which applies to any of the arguments is printed. For example ‘last root 
console’ would list all of "root’s"” sessions as well as all sessions on the console terminal. 
Last prints the sessions of the specified users and teletypes, most recent first, indicating the times at which 
the session began, the duration of the session, and the teletype which the session took place on. Last also 
indicates if the session is still continuing or was cut short by a reboot. 


The pseudo-user reboot logs in at reboots of the system, thus 
last reboot 
will give an indication of mean time between reboot. 
Last with no arguments prints a record of all logins and logouts, in reverse order. 
If last is interrupted, it indicates how far the search has progressed in wtmp. If interrupted with a quit sig- 
nal (generated by a control-\), last indicates how far the search has progressed and continues the search. 


OPTION 
—N Limits the report to N lines. 


FILES 

/usr/adm/wtmp login data base 

/usr/adm/shutdownlog record of shutdowns and reasons for wtmp 
SEE ALSO 


lastcomm(1) wtmp(5), ac(8), 
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NAME 
lastcomm — show last commands executed in reverse order 


SYNOPSIS 
lastcomm [ command name }... [ user name } ... [ terminal name } ... 

DESCRIPTION 
Lastcomm gives information on previously executed commands. With no arguments, lastcomm prints 
information about all the commands recorded during the current accounting file’s lifetime. If called with 
arguments, lastcomm prints only accounting entries with a matching command name, user name, or termi- 
nal name. For example, 

lastcomm a.out root ttyd0 

would produce a listing of all the executions of commands named a.out by user root on the terminal ttyd0. 


For each process entry, lastcomm prints the following: 


e the name of the user who ran the process. 

e flags, as accumulated by the accounting facilities in the system. 
e the command name under which the process was called. 

e the amount of cpu time used by the process (in seconds). 

e the time the process exited. 


The flags are encoded as follows: 
indicates the command terminated with the generation of a core file 


indicates the command ran after a fork, but without a following exec 
indicates the command was executed by the super-user 


x nam 


indicates the command was terminated with a signal. 


FILES 
/usr/adm/acct 


SEE ALSO 
last(1), sigvec(2), core(5) acct(8), 
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_ NAME 

Id — link editor 
SYNOPSIS — 

Id [ options ] files 
_ DESCRIPTION | 
Ld combines several object programs into one, resolves external references, and searches libraries. In the 
simplest case several object files are given, and Id combines them, producing an rie module which can 
be either executed or become the input for a further Id run. (In the latter case, the —r option must be given 


to preserve the relocation bits.) The output of Id is left on a.out. This file is made executable only if no 
errors occurred during the load. 


The argument routines are concatenated in the order specified. The entry point of the output is the begin- 
ning of the first routine (unless the —e option is specified). 


If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer- 
ences another routine in the library, and the library has not been processed by ranlib(1), the referenced 
routine must appear after the referencing routine in the library. Thus the order of programs within libraries 
may be important. The first member of a library should be a file named ‘__.SYMDEF’, which is under- 
stood to be a dictionary for the library as produced by ranlib(1); the dictionary is searched iteratively to 
Satisfy as many references as possible. 


The symbols _etext, edata and _end (etext, edata and end in C) are reserved and, if referred to, are set to 
the first location above the program, the first location above initialized data, and the first location above all 
data respectively. It is erroneous to define these symbols. 

OPTIONS 

Except for —L, options should appear before the filenames. 

—-A Specifies incremental loading, i.e. linking is to be done in a manner so that the resulting object 
may be read into an already executing program. The next argument is the name of a file whose 
symbol table will be taken as a basis on which to define additional symbols. Only newly linked 
material will be entered into the text and data portions of a.out, but the new symbol table will 
reflect every symbol defined before and after the incremental load. This argument must appear 
before any other object file in the argument list. The ~T option may be used as well, and will be 
taken to mean that the newly linked segment will commence at the corresponding address (which 
must be a multiple of 1024). The default value is the old value of _end. 


—d Forces definition of common storage even if the —r flag is present. 


—Dhex Takes the next argument as a hexadecimal number and pad the data segment with zero bytes to the 
indicated length. 


~ep Takes p to be the entry point of the loaded program; location 0 is the default. 


-lstr This option is an abbreviation for the library name libstr.a, where str is a string. Ld searches for 
libraries first in any directories specified with —L options, then in the standard directories ‘/lib’, 
‘/ust/lib’, and ‘/usr/local/lib’. A library is searched when its name is encountered, so the place- 
ment of a —I is significant. —Ldir Adds dir to the list of directories in which Id searches for 
libraries. Ld searches the directories specified with —L before it searches the standard directories. 


—M Produces a primitive load map, listing the names of the files which will be loaded. 


—n Arranges (by giving the output file a 0410 "magic number") that when the output file is executed, 
; the text portion will be read-only and shared among all users executing the file. This involves 
moving the data areas up to the first possible 1024 byte boundary following the end of the text. 


| -N Does not make the text portion read only or sharable. (Uses "magic number" 0407.) 
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Uses the name argument after —o as the name of the Id output file, instead of a.out. 


-r Generates relocation bits in the output file so that the file can be the subject of another Id run. 
This flag also prevents final definitions from being given to common symbols, and suppresses the 
‘undefined symbol’ diagnostics. 

Ss "Strips" the output, that is, removes the symbol table and relocation bits to save space (but impair 
the usefulness of the debuggers). You can also remove this information with strip(1). 

-S "Strips" the output by removing all symbols except locals and globals. 

+t Print the name of each file as it is processed. (Trace.) 

—T hex Uses hex to set the text segment origin. The default origin is 0. 

—u Takes the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an 
unresolved reference is needed to force the loading of the first routine. 

-x Tells Id not to preserve local (non-.globl) symbols in the output symbol table; only enter external 
symbols. This option saves some space in the output file. . 

~X Saves local symbols except for those whose names begin with ‘L’. Cc(1) uses this option to dis- 
card internally-generated labels while retaining symbols local to routines. 

—ysym Indicates each file in which sym appears, its type and whether the file defines or references it. 
Many such options may be given to trace many symbols. (It is usually necessary to begin sym 
with an “_’, as external C, FORTRAN and Pascal variables begin with underscores.) 

-Z Arranges for the process to be loaded on demand from the resulting executable file (413 format) 
rather than preloaded. This is the default. Results in a 1024 byte header on the output file fol- 
lowed by a text and data segment each of which have size a multiple of 1024 bytes (being padded 
out with nulls in the file if necessary). With this format the first few BSS segment symbols may 
actually appear (from the output of size(1)) to live in the data segment; this to avoid wasting the 
space resulting from data segment size roundup. 

FILES 

/lib/lib*.a libraries 

/usr/lib/lib*.a more libraries 

/usr/local/lib/lib+.a _ still more libraries 

a.out output file 

SEE ALSO 
ar(1), as(1), cce(1), ranlib(1) 
BUGS 


There is no way to force data to be page aligned. Ld pads images which are to be demand loaded from the 
file system to the next page boundary to avoid a bug in the system. 
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NAME 


learn — computer aided instruction about UNIX 


SYNOPSIS 


learn [ — directory } [ subject [ lesson ] ] 


DESCRIPTION 


Learn gives computer aided instruction courses and practice in the use of UNIX, the C Shell, and the 
Berkeley text editors. To get started simply type learn. If you had used learn before and left your last ses- 
sion without completing a subject, the program will use information in $HOME/.learnrc to start you up in 
the same place you left off. Your first time through, learn will ask questions to find out what you want to 
do. Some questions may be bypassed by naming a subject, and more yet by naming a lesson. You may 
enter the lesson as a number that learn gave you in a previous session. If you do not know the lesson 
number, you may enter the lesson as a word, and learn will look for the first lesson containing it. If the les- 
son is ‘—’, learn prompts for each lesson; this is useful for debugging. 


The subjects currently covered are files, editor, vi, morefiles, macros, eqn, and C. 


COMMANDS | 
There are a few special commands. 
again Re-displays the text of the lesson. 
again lesson Lets you review lesson. 
bye Terminates a learn session. 
hint Prints the last part of the lesson script used to evaluate a response. Learn cannot tell you in 
English the answers it expects, but hint can provide you with a few clues. 
hint m Prints the whole lesson script. This command is useful for debugging lessons. 
where - tells you the state of your progress. 
wherem __ Tells you more about your progress. 
OPTIONS 
—directory Lets you exercise a script in a nonstandard place. 
FILES 
/usr/lib/learn subtree for all dependent directories and files 
/usr/tmp/pl+* playpen directories: temporary directories created 
by learn in which users can practice 
use of the system 
$HOME/.learnrc startup information — 
SEE ALSO 
esh(1), ex(1) | 
B. W. Kernighan and M. E. Lesk, LEARN — Computer-Aided Instruction on UNIX 
BUGS 


The main strength of learn, that it asks the student to use the real UNIX, also makes possible baffling mis- 
takes. It is helpful, especially for nonprogrammers, to have a UNIX initiate near at hand during the first 
sessions. 


Occasionally lessons are incorrect, sometimes because the local version of a command operates in a non- 
standard way. Occasionally a lesson script does not recognize all the different correct responses, in which 
case the ‘hint’ command may be useful. Such lessons may be skipped with the ‘skip’ command, but it 
takes some sophistication to recognize the situation. 


To find a lesson given as a word, learn does a simple fgrep( 1) through the lessons. It is unclear whether 
this sort of subject indexing is better than none. 
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Spawning a new shell is required for each of many user and internal functions. 
The vi lessons are provided separately from the others. To use them see your system administrator. 
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NAME 


leave ~— remind you when you have to leave 


SYNOPSIS 


leave [ [+] him ] 


DESCRIPTION 


Leave is an online alarm clock that reminds you to leave at the specified time. When the time arrives for 
the alarm to go off, Leave prints messages on your screen warning you not to be late. The messages 
appear 5 minutes before the alarm time, 1 minute before the alarm time, at the alarm time, and each minute 
thereafter. When you log off, leave exits just before it would have printed the next message. 


You specify the time of day in the form hhmm, where hh is hours (on a 12 or 24 hour clock) and mm is 


minutes. Leave converts all times to a 12 hour clock and assumes that the specified time is in the next 12 
hours. 


If the time is preceeded by ‘+’, the alarm will go off in hours and minutes from the current time. 
If no argument is given, leave prompts with "When do you have to leave?". A reply of newline causes 


leave to exit; otherwise, leave interprets the reply as a time. You can include this form of leave in your 
login or .profile. 


Leave ignores interrupts, quits, and terminates. To deactivate leave, log out or use kill —9, giving its pro- 
cess id. 


SEE ALSO 


calendar(1) 
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NAME 
lex — generator of lexical analysis programs 


SYNOPSIS 
lex [ options ] [ file}... 


DESCRIPTION 
Lex generates programs to be used in simple lexical analyis of text. The input files (standard input default) 
contain regular expressions to be searched for and actions written in C to be executed when expressions are 
found. 


Lex generates a C source program, lex.yy.c, to be compiled thus: 
cc lex.yy.c —ll 


This program, when run, copies unrecognized portions of the input to the output and executes the associ- 
ated C action for each regular expression that is recognized. 


OPTIONS 
—f "Faster" compilation: don’t bother to pack the resulting tables; limited to small programs. 


—n Opposite of —v; —n is default. 
-t Place the result on the standard output instead of in file "lex.yy.c". 
-V Print a one-line summary of statistics of the generated analyzer. 


EXAMPLE 
The command 


lex lexcommands 
would draw lex instructions from the file lexcommands, and place the output in lex.yy.c 
Below is an example of a lex program that would be put into a lex command file. 


%% 

[A-Z] putchar(yytext[0]+’a—"A’); 
[]+$ ; 

[]+  putchar(’ ’); 


This program converts upper case to lower, removes blanks at the end of lines, and replaces multiple 
blanks by single blanks. 
SEE ALSO 
sed(1), yacc(1) 
M. E. Lesk and E. Schmidt, LEX — Lexical Analyzer Generator 
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NAME 
lint — a C program verifier 

SYNOPSIS 
lint [ options ] file ... 

DESCRIPTION | 
Lint tries to detect features of the C program files which are likely to be bugs, non-portable, or wasteful. It 
also checks the type usage of the program more strictly than the compilers. Among the things lint 
currently finds are unreachable statements, loops not entered at the top, automatic variables declared and 
not used, and logical expressions whose value is constant. Moreover, lint checks the usage of functions to 
find functions that return values in some places and not in others, functions called with varying numbers of 
arguments, and functions whose values are not used. _ 
By default, lint assumes that all the files are to be loaded together. Lint checks them for mutual compatibil- 
ity. Function definitions for certain libraries are available to lint. These libraries are referred to by a con- 
ventional name, such as ‘—lm’, in the style of Id(1). Arguments ending in .Jn are “ treated as library 
files. To create lint libraries, use the —C option: 


lint —Cfoo files... 


where files are the C sources of library foo. The result is a file /lib-Ifoo.In in the correct library format suit- 
able for linting programs using foo. 


~ OPTIONS 
You can use any number of the following options with lint(1). The -D, —-U, and -I options of cc(1) are also 
recognized as separate arguments. 


a Reports assignments of long values to int variables. 


b Reports break statements that cannot be reached. (This is not the default because, unfortunately, 
most lex and many yacc outputs produce dozens of such comments.) 


Complains about casts which have questionable portability. 

Applies a number of heuristic tests to attempt to intuit bugs, improve style, and reduce waste. 
Does not check compatibility against the standard library. 

Attempts to check portability to the JBM and GCOS dialects of C. 


Does not complain about functions and variables used and not defined, or defined and not used 
(this is suitable for running lint on a subset of files out of a larger program). 


csc vu nF A 


Vv Suppresses complaints about unused arguments in functions. 
x Reports variables referred to by extern declarations, but never used. 


Do not complain about structures that are never defined (e.g. using a structure pointer without 
knowing its contents.). 
Exit(2) and other functions which do not return are not understood; this causes various lies. 
Certain conventional comments in the C source will change the behavior of lint: 
_/*NOTREACHED*/ 
at appropriate points stops comments about unreachable code. 


/*VARARGSn */ 
suppresses the usual checking for variable numbers of arguments in the following function 
declaration. The data types of the first n arguments are checked; a sUSEIE n is taken to be 0. 


/*NOSTRICT*#/ 
shuts off strict type checking in the next expression. 


/*ARGSUSED+/ 
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turns on the —v option for the next function. 


/*LINTLIBRARY*/ 
at the beginning of a file shuts off complaints about unused functions in this file. 


FILES 
/usr/lib/lintv/lint{12] programs 
/usr/lib/lint/llib-Ic.In declarations for standard functions 
/usr/lib/liny/llib-Ic human readable version of above 
/usr/lib/lint/llib-port.In declarations for portable functions 
/usr/lib/linv/llib-port | human readable... 


llib-1*.In library created with —C 
SEE ALSO 

ec(1) 

S. C. Johnson, Lint, a C Program Checker 


BUGS 
There are some things you just can’t get lint to shut up about. 


/*NOSTRICT*/ is not implemented in the current version (alas). 
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NAME 
lisp — lisp interpreter 

SYNOPSIS 
lisp 

_ DESCRIPTION 
. Lisp is a lisp interpreter for a dialect which closely resembles MIT’s MACLISP. This lisp, known as — 

FRANZ LIsP, features an I/O facility which allows the user to change the input and output syntax, add 
macro characters, and maintain compatibility with upper-case only lisp systems; infinite precision integer 
arithmetic, and an error facility which allows the user to trap system errors in many different ways. Inter- 
preted functions may be mixed with code compiled by liszt(1) and both may be debugged using the 
‘‘Joseph Lister’ trace package. A lisp containing compiled and interpreted code may be dumped into a 
file for later use. 
There are too many functions to list here. Please refer to the manuals listed below. 

FILES 
/usr/lib/lisp/trace.1 Joseph Lister trace package 
/usr/lib/lisp/toplevel.1 | top level read-eval-print loop 

SEE ALSO 
liszt(1), Ixref(1) 
“FRANZ LISP Manual, Version 1’ by John K. Foderaro 

. MACLISP Manual 

BUGS 


The error system is in a state of flux. Also, not all error messages are as informative as they could be. 
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NAME 
liszt — compile a Franz Lisp program 
SYNOPSIS 
liszt [ options } [ filename } 
DESCRIPTION 
Liszt compiles the FRANZ LISP code in the specified file and writes the output to an object file. The Lisp 
file’s filename must end in ‘.1’. Liszt gives the object file the same name as the Lisp file, with the ‘.1’ suffix 
Changed to ‘.o’. 
If you do not specify a source file, the compiler runs interactively. In this case, you will talk to lisp(1) top- 
level command interpreter. You can compile a file by using the function liszt (an nlambda) with the same 
arguments as you use on the command line. For example to compile ‘foo’, a MACLISP file, you would use: 
(liszt —m foo) 
Note that liszt supplies the ‘‘.1’’ extension-for you. 
OPTIONS | 
—C Puts comments in the assembler output of the compiler. Useful for debugging the compiler. 
—e form Evaluates the given form before compilation begins. 
—m Compiles a MACLIsP file, by changing the readtable to conform to MACLISP syntax and including a 
macro-defined compatibility package. 
—0 objfile 
Puts the object code in the specified file, rather than the default ‘.o’ file. 
-p Places profiling code at the beginning of each non-local function. If the lisp system is also created 
with profiling in it, this allows function calling frequency to be determined (see prof(1).) 
—q Prints only warning and error messages. Compilation statistics and notes on correct but unusual 
constructs will not be printed. 
-Q Prints compilation statistics and warn of strange constructs. This is the default. 
-r Places bootstrap code at the beginning of the object file. When the object file is executed, the 
bootstrap code will invokke a lisp system and fasl in the object file. 
-§ Compiles the named program and leave the assembler-language output on the corresponding file 
suffixed ‘.s’. This also prevents the assembler language file from being assembled. 
-T Sends the assembler output to standard output. 
—uU Compiles a UCI-lispfile, by changing the readtable to conform to UCI-Lisp syntax and including a 
macro-defined compatibility package. 
-w Suppresses warning diagnostics. 
-x Creates a lisp cross reference file with the same name as the source file but with ‘.x’ appended. 
The program bxref(1) reads this file and creates a human readable cross reference listing. 
FILES : 
/usr/lib/lisp/machacks.1 MACLISP compatibility package 
/usr/lib/lisp/syscall.1 macro definitions of Unix system calls 
/usr/lib/lisp/ucifnc.1 UCI Lisp compatibility package 
SEE ALSO 


lisp(1), Ixref(1) 
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In — make links 


SYNOPSIS 


In [ option | sourcename [ targetname } 
In [—s ] sourcename!l sourcename? [ sourcename3 ... | targetdirectory 


DESCRIPTION 


OPTION 


A link is a directory entry referring to a file; the same file (together with its size, all its protection informa- 
tion, etc.) may have several links to it. There are two kinds of links: hard links and symbolic links. 


By default In makes hard links. A hard link to a file is indistinguishable from the original directory entry; 
any changes to a file are effective independent of the name used to reference the file. Hard links may not 
span file systems and may not refer to directories. . 


The —s option causes In to create symbolic links. A symbolic link contains the name of the file to which it 
is linked. The referenced file is used when an open(2) operation is performed on the link. A stat(2) on a 
symbolic link returns the linked-to file. You can obtain information about the link with an Istat(2), and you 
can use the readlink(2) call to read the contents of a symbolic link. Symbolic links may span file systems 
and may refer to directories. 


Given one or two arguments, In creates a link to an existing file sourcename. If targetname is given, the 
link has that name; targetname may also be a directory in which to place the link; otherwise it is placed in 
the current directory. If only the directory is specified, the link will be made to the last component of sour- 
cename. 


Given more than two arguments, In makes links in targetdirectory to all the named source files. The links 
made will have the same name as the files being linked to. 


a) Causes In to create symbolic links. The DESCRIPTION section above discusses symbolic links in 
detail. 


SEE ALSO 


rm(1), cp(1), mv(1), link(2), readlink(2), stat(2), symlink(2) 
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NAME 
lock — reserve a terminal 
SYNOPSIS 
lock [ —nwmber ] 
DESCRIPTION 
Lock requests a password fromthe user, reads it again for verification, then locks the terminal until the 
user enters the password. There are three other conditions under which lock will release a terminal: 
e Lock accepts the root password for root as an alternative to the one given by the user. 
e Lock will timeout after some interval of time (15 minutes, by default). 
e A user will the appropriate permission can kill lock’s process. 
Normally, lock will time out after 15 minutes. 


OPTIONS 
—number Sets the time limit for lock to number minutes, instead of the default 15. 
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NAME | 
logger — make entries in the system log 
SYNOPSIS 
logger [ options ] [ message } 
DESCRIPTION 
Logger provides a program interface to the syslog(3) system log module. 


Logger takes the message you typed on the command line and logs it immediately in the system log. If 
you want to log a file instead of a command line message, use the —f option to tell logger which file to read. 
Logger then logs each line of the file in the system log. If you do not specify a message or a file to log 
from, logger reads from the standard input. 


OPTIONS 
—f file Logs the specified file. 


-i Logs the process id of the logger process with each line. 


—p pri Enters the message with the specified priority. The priority may be specified numerically or 
as a ‘‘facility.level’’ pair. For example, ‘‘—p local3.info’’ logs the message(s) as 
informational level in the local3 facility. The default is ‘“user.notice.”’ 


—t tag Marks every line in the log with the specified tag. 


EXAMPLES 
logger System rebooted 


logger —p local0.notice -t HOSTIDM -f /dev/idmc 


SEE ALSO 
syslog(3), syslogd(8) 
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NAME 
login — sign on 
SYNOPSIS 
login [ username ] 
DESCRIPTION 
The login command is used when a user initially signs on, or it may be used at any time to change from one 
user to another. The latter case is described here. See ‘‘Getting Started’’ in ‘‘Introduction’’ of the UNIX 
User’ s Reference Manual for information on how to dial up initially. 
If login is invoked without an argument, it prompts for a user name, and if appropriate, a password. If pos- 
sible, echoing is turned off during the entry of the password, so that it will not appear on the written record 
of the session. 
After a successful login, accounting files are updated. The user is informed of the existence of mail and the 
message of the day is printed. In addition, the time the user last logged in is printed, unless there is a 
“* hushlogin”’ file in his or her home directory. (This is primarily for the benefit of uucp, etc.) 
Login initializes the user and group IDs and the working directory, then executes a command interpreter 
(usually sh(1)) according to specifications found in a password file. Argument 0 of the command inter- 
preter is —sh; or more generally, the name of the command interpreter preceded by a leading dash (—). 
Login also initializes the environment (environ(7)), specifying home directory, command interpreter, ter- 
minal type (if available) and user name. 
OPTIONS 
—d Used to indicate desktop logins on graphics workstations. If —d is specified, login will start up a 
desktop manager instead of the user’s login shell. Login searches for a desktop manager in the 
file .dm in the user’s home directory; if that does not exist or is not executable, it tries /usr/lib/dm. 
Finally, if /usr/lib/dm does not exist or is not executable, /bin/dm ( dm(1) ) is used as the desktop 
manager. This scheme allows individual users to provide their own desktop managers (in .dm) or 
a means to provide a system wide desktop manager (in /usr/lib/dm). 
-r Used by the remote login daemon, rlogind(8C), to force login to enter into an initial connection 
protocol. 
If the file /etc/nologin exists, login disables any further logins, displays any message it contains, and exits. 
This is used by shutdown(8) to stop users from logging in when the system is about to go down. 
Login is recognized by sh(1) and csh(1) and is executed directly (without forking). 
FILES | 
/etc/utmp accounting | 
/usr/adm/wtmp accounting 
/usr/spool/mail/* mail | 
/etc/motd message-of-the-day 
/etc/passwd password file 
/etc/nologin stops logins 
-hushlogin makes login quieter 
/etc/securetty _lists trys that root may log in on 
_ SEE ALSO 
 init(8), getty(8), dm(1), mail(1), passwd(1), passwd(5), environ(7), shutdown(8) 
DIAGNOSTICS 


““Login incorrect,”’ if the name or the password is invalid. 
“‘No shell,’’ ‘Cannot open password file,’’ ‘“No directory’’: consult a system expert. 
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NAME 
look — find lines in a sorted list 


SYNOPSIS 
look [ options ] string [ file ] 


DESCRIPTION | : 
Look consults a sorted file and prints all lines that begin with string. It uses binary search. 


If you do not specify a file, look uses /ust/dict/words with the collating sequence —df. 


_ OPTIONS 


The options d and f affect comparisons as in sort(1): 
—d Searches in ‘dictionary’ order: only letters, digits, tabs and blanks participate in comparisons. 
-—f Folds the letters. Upper case letters compare equal to lower case. 


FILES 
/usr/dict/words 


SEE ALSO 
sort(1), grep(1) 
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NAME 
indxbib, lookbib — build inverted index for a bibliography, find references in a bibliography 

SYNOPSIS 
indxbib database ... 
lookbib [ —n ] database 

DESCRIPTION 
Indxbib makes an inverted index to the named databases or files for use by lookbib(1) and refer(1). 
These files contain bibliographic references (or other kinds of information) separated by blank lines. 
A bibliographic reference is a set of lines, constituting fields of bibliographic information. Each field starts 
on a line beginning with a ‘‘%’’, followed by a key-letter, then a blank, and finally the contents of the field, 
which may continue until the next line starting with ‘‘%’’. 
Indxbib is a shell script that calls /usr/lib/refer/mkey and /usr/lib/refer/inv. The first program, mkey, trun- 
cates words to 6 characters, and maps upper case to lower case. It also discards words shorter than 3 char- 
acters, words among the 100 most common English words, and numbers (dates) < 1900 or > 2000. These 
parameters can be changed; see page 4 of the Refer document by Mike Lesk. The second program, inv, 
Creates an entry file (.ia), a posting file (.ib), and a tag file (.ic), all in the working directory. 
Lookbib uses an inverted index made by indxbib to find sets of bibliographic references. It reads key- 
words typed after the ‘‘>’’ prompt on the terminal, and retrieves records containing all these keywords. If 
nothing matches, nothing is returned except another ‘‘>’’ prompt. 
Lookbib asks if you need instructions. If you reply ‘‘y,’’ lookbib prints some brief information about 
using lookbib. The ‘‘—n’’ flag turns off the prompt for instructions. 
It is possible to search multiple databases, as long as they have a common index made by indxbib. In that 
case, only the first argument given to indxbib is specified to lookbib. 
If lookbib does not find the index files (the .i[abc] files), it looks for a reference file with the same name as 
the argument, without the suffixes. It creates a file with a ’.ig’ suffix, suitable for use with fgrep. It then 
uses this fgrep file to find references. This method is simpler to use, but the .ig file is slower to use than the 
ilabc] files, and does not allow the use of multiple reference files. 

FILES 
x.ia, x.ib, x.ic, where x is the first argument, or if these are not present, then x.ig, x 

SEE ALSO 
refer(1), addbib(1), sortbib(1), roffbib(1), lookbib(1) 

BUGS 


Probably all dates should be indexed, since many disciplines refer to literature written in the 1800s or ear- 
lier. | 
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NAME 
lorder — find ordering relation for an object library 


SYNOPSIS 
lorder file ... 


DESCRIPTION 
Lorder reads one or more object or library archive files and produces a list of pairs of object filenames. 
The first file of the pair refers to external identifiers defined in the second. You can process the output with 
tsort(1) to find an ordering of a library suitable for one-pass access by Id(1). (See ar(1) for information on 
library archive files.) | 
The need for lorder may be vitiated by use of ranlib(1), which converts an ordered archive into a ran- 
domly accessed library. 

EXAMPLE 
This brash one-liner intends to build a new library from existing ‘.o’ files. 


ar cr library ~ lorder *.0 | 


FILES 
*symref, *symdef 
~ am(1), sed(1), sort(1), join(1) 
SEE ALSO 
tsort(1), Id(1), ar(1), ranlib(1) 


BUGS 
The names of object files, in and out of libraries, must end with ‘.o’. Otherwise, nonsense results. 
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Ipq — spool queue examination program 


SYNOPSIS 


Ipq [ options ] [ job# ...] [ user... ] 


DESCRIPTION 


Lpq examines the spooling area used by Ipd(8) for printing files on the line printer and reports the status of 
the specified jobs or all jobs associated with a user. 


For each job submitted (each invocation of Ipr(1)), Ipq reports the user’s name, current rank in the queue, 
the names of files comprising the job, the job identifier (a number which may be supplied to Iprm(1) for 
removing a specific job), and the total size in bytes. Job ordering is dependent on the algorithm used to 
scan the spooling directory and is supposed to be FIFO (First In First Out). If you or another user uses 
Ipr(1) as a sink in a pipeline, Ipq may not be able to discover the filenames in the queue. In this case, Ipq 
labels the file as ‘‘(standard input)". 


Without any arguments, Ipq reports on any jobs currently in the queue. 


If lIpq warns that there is no daemon present (i.e. due to some malfunction), you can use the Ipc(8) com- 
mand to restart the printer daemon. 


OPTIONS 


+ Displays the spool queue until it empties. 
+n Displays the spool queue until it empties, but sleeps n seconds in between scans of the queue. 


-I Prints information about each of the files comprising the job. Normally, only as much information 
as will fit on one line is displayed. 

—Pprinter 
Specifies a particular printer. Without this option, Ipq checks the default line printer or the value 
of the PRINTER variable in the environment. 


All other arguments supplied are interpreted as user names or job numbers to filter out only those jobs of 
interest. 


FILES 
/etc/termcap for manipulating the screen for repeated display 
/etc/printcap tc determine printer characteristics 
/ust/spool/* the spooling directory, as determined from printcap 
/usr/spool/*/cf* control files specifying jobs 
/usr/spool/*/lock the lock file to obtain the currently active job 
SEE ALSO 
Ipr(1), Iprm(1), Ipe(8), Ipd(8) 
BUGS 
Due to the dynamic nature of the information in the spooling directory Ipq may report unreliably. 
Output formatting is sensitive to the line length of the terminal. Sometimes this results in widely spaced 
columns. . 
DIAGNOSTICS 
Unable to open various files. 
The lock file being malformed. 


Garbage files when there is no daemon active, but files in the spooling directory. 
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NAME 
Ipr — off line print 
SYNOPSIS 
Ipr [ options ] [ filename ...] © 
DESCRIPTION 
Lpr uses a spooling daemon to print the named files when facilities become available. If no names appear, 
the standard input is assumed. 


The single letter options below are used to notify the line printer spooler that the files are not standard text 
files. The spooling daemon will use the appropriate filters to print the data accordingly. 


OPTIONS . 
—#num Prints out num copies of each file named. For example, 
Ipr —#3 foo.c bar.c more.c 
would result in-3 copies of the file foo.c, followed by 3 copies of the file bar.c, etc. On the other 
hand, . 
cat foo.c bar.c more.c | lpr —#3 
will give three copies of the concatenation of the files. 
—num font 
Specifies a font to be mounted on font position i, Num is a font number from 1 to 4. The daemon 
will construct a .railmag file referencing /usr/lib/vfont/name.size. 
~ Assumes the files to contain data produced by cifplot(1). 


—-C 
—C Takes the following argument as a job classification for use on the burst page. For example, 
Ipr —C EECS foo.c 
Causes the system name (the name returned by hostname(1)) to be replaced on the burst page by 
EECS, and the file foo.c to be printed. 


-=d = Assumes the files to contain data from tex(1) (DVI format from Stanford). 


-f Uses a filter which interprets the first character of each line as a standard FORTRAN carriage con- 
trol character. 


-g Assumes the files to contain standard plot data as produced by the plot(3X) routines (see also 
plot(iG) for the filters used by the printer spooler). 


—h Suppresses the printing of the burst page. 


-inum Causes the output to be indented. If the next argument is numeric, it is used as the number of 
blanks to be printed before each line; otherwise, 8 characters are printed. 


—Jjob Takes job as the job name to print on the burst page. Normally, the first file’s name is used. 
-l Uses a filter which allows control characters to be printed and suppresses page breaks. 

—n Assumes the files to contain data from ditroff (device independent troff). 

—p Uses pr(1) to format the files (equivalent to print). 


—Pprinter 
Forces output to a specific printer. Normally, the default printer is used (site dependent), or the 
value of the environment variable PRINTER is used. 


—r Removes the file upon completion of spooling or upon mpi of printing (with the —s option). 
_m Sends mail when printing is finished. 


-s___ Uses symbolic links to copy files to the spool directory. This option uses symlink(2) to link data 
files rather than trying to copy them so large files can be printed. This means the files should not 
be modified or removed until they have been printed. 
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-t Assumes the files to contain data from troff(1) (cat phototypesetter commands). 
—T title Takes the title for the title used by pr(1) instead of the filename. 

-v Assumes the files to contain a raster image for devices like the Benson Varian. 
—wnum Takes num to be the page width for pr. 


FILES 
/etc/passwd personal identification 
/etc/printcap printer capabilities data base 
/usr/lib/Ipd* line printer daemons 
/ust/spool/* directories used for spooling 
/usr/spool/*/cf* | daemon control files 
/ust/spool/*/df* — data files specified in "cf" files 
/usr/spool/*/tf* temporary copies of "cf" files _ 
SEE ALSO 
Ipq(1), Iprm(1), pr(1), symlink(2), printcap(5S), Ipc(8), Ipd(8) 
DIAGNOSTICS 
If you try to spool too large a file, it will be truncated. Lpr will object to printing binary files. If a user 
other than root prints a file and spooling is disabled, lpr will print a message saying so and will not put jobs 
in the queue. If a connection to Ipd on the local machine cannot be made, Ipr will say that the daemon 
Cannot be started. Diagnostics may be printed in the daemon’s log file regarding missing spool files by Ipd. 
BUGS 


Fonts for troff and tex reside on the host with the printer. It is currently not possible to use local font 
libraries. 
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NAME 


Iprm — remove jobs from the line printer spooling queue 


SYNOPSIS 


Iprm [ options ] [ job# ] [ user(s) ] 


DESCRIPTION 


Lprm removes a job or jobs from a printer’s spool queue. Since the spooling directory is protected from 
users, using Iprm is normally the only method by which a user may remove a job. 


Without any arguments, Lprm deletes the currently active job if it is owned by the user who invoked tprm. 
A user may dequeue an individual job by specifying its job number. This number may be obtained from the 
Ipq(1) program. For example: 

% ipq —1 


1st: ken [job #013ucbarpa] 
(standard input) 100 bytes 
% Iprm 13 


Lprm announces the names of any files it removes and is silent if there are no jobs in the queue that match 
the request list. 


Lprm kills off an active daemon, if necessary, before removing any spooling files. If a daemon is killed, 
Iprm automatically starts a new one upon completion of file removals. 


OPTIONS 


FILES 


SEE ALSO 


- Causes Iprm to remove all jobs that a user owns. If the super-user employs this flag, the 
spool queue will be emptied entirely. The owner is determined by the user’s login name and 
hostname on the machine where the Ipr command was invoked. 


—Pprinter Specifies the queue associated with a specific printer (otherwise the default printer, or the 
value of the PRINTER variable in the environment is used). 


job# Dequeues an individual job by specifying its job number. 


user(s) Causes Iprm to remove any jobs queued belonging to the specified user or users. Only the 
super-user can use this option of Iprm. 


/etc/printcap printer characteristics file 

/usr/spool/* spooling directories 

/ust/spool/*/lock lock file used to obtain the pid of the current 

daemon and the job number of the currently active job 


Ipr(1), Ipq(1), Ipd(8) 


DIAGNOSTICS 


_ BUGS 


‘‘Permission denied" if the user tries to remove files other than his own. 


Since there are race conditions possible in the update of the lock file, the currently active job may be 
incorrectly identified. 
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NAME 

Iptest — generate lineprinter ripple pattern 
SYNOPSIS 

Iptest [ length [ count }} 


DESCRIPTION 
Lptest writes the traditional "ripple test" pattern on standard output. In 96 lines, this pattern will print all 
96 printable ASCII characters in each position. While originally created to test printers, it is quite useful 
for testing terminals, driving terminal ports for debugging purposes, or any other task where a quick supply 
of random data is needed. 
The length argument specifies the output line length if the the default length of 79 is inappropriate. 


The count argument specifies the number of output lines to be generated if the default count of 200 is inap- 
propriate. Note that if you specify count, you must also specify length. 
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NAME 


ls — list contents of directory 
SYNOPSIS 
Is [ options ] name ... 
DESCRIPTION | | 
. For each directory argument, Is lists the contents of the directory; for each file argument, Is repeats its name 
and any other information requested. By default, the output is sorted alphabetically. When no argument is 
given, the current directory is listed. When several arguments are given, the arguments are first sorted 
appropriately, but file arguments are processed before directories and their contents. 
The group-execute permission character is given as s if the file has the set-group-id bit set; likewise the 
user-execute permission character is given as s if the file has the set-user-id bit set. 
The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit of the mode is on. See chmod(1) 
for the meaning of this mode. 
When the sizes of the files in a directory are listed, a total count of blocks, including indirect blocks is 
The mode printed under the —! option contains 11 characters which are interpreted as follows: the first 
character is 
d_ if the entry is a directory; 
b_ if the entry is a block-type special file; 
cif the entry is a character-type special file; 
1 if the entry is a symbolic link; 
s_ if the entry is a socket, or 
— if the entry is a plain file. . . 
The next 9 characters are interpreted as three sets of three bits each. The first set refers to owner permis- 
sions; the next refers to permissions to others in the same user-group; and the last to all others. Within each 
set the three characters indicate permission respectively to read, to write, or to execute the file as a pro- 
gram. For a directory, ‘execute’ permission is interpreted to mean permission to search the directory. The 
permissions are indicated as follows: | 
r_ if the file is readable; 
w if the file is writable; 
x if the file is executable; 
— if the indicated permission is not granted. 
OPTIONS — | . 
-a Lists all entries. In the absence of this option, Is does not list entries whose names begin with a 
period (.). 
+ Uses time of file creation for sorting or printing. 


-C Forces multi-column output. This is the default when output is to a terminal. 
-d If argument is a directory, lists only its name; often used with —I to get the status of a directory. 


-~f __ Forces each argument to be interpreted as a directory and lists the name found in each slot. This 
option turns off —1, —t, —s, and —r, and turns on —a. The order is the order in which entries appear 
in the directory. 

—-F Marks directories with a trailing ‘/’, sockets with a trailing ‘=’, symbolic links with a trailing ‘@’, 

| and executable files with a trailing ‘*’. | 

-g Includes the group ownership of the file in a long output. 


ie | For each file, prints the i-number in the first column of the report. 
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Lists in long format, giving mode, number of links, owner, size in bytes, and time of last 
modification for each file. If the file is a special file, the size field will contain the major and 
minor device numbers. If the file is a symbolic link, the pathname of the linked-to file is printed 
preceded by ‘‘—>’’. 


If argument is a symbolic link, lists the file or directory the link references rather than the link 
itself. 


Forces printing of non-graphic characters in filenames as the character ‘?’. This is the default 
when output is to a terminal. 

Reverses the order of sort to get reverse alphabetic or oldest first as appropriate. 

Recursively lists subdirectories Is encounters. 

Gives size in kilobytes of each file. 

Sorts by time modified (latest first) instead of by name. 


Uses time of last access instead of last modification for sorting (with the —t option) and/or printing 
(with the —I option). 


Forces one entry per line output format. This mode is the default when output is not to a terminal. 


etc/passwd to get user id’s for ‘is -l’. 
/etc/group to get group id’s for ‘Is —g’. 


BUGS. 


Ls considers newline and tab to be printing characters in filenames. 
The output device is assumed to be 80 columns wide. 


The option setting based on whether the output is a teletype is undesirable as ‘‘Is —s’’ is much different 
than ‘‘ls —s | Ipr’’. On the other hand, not doing this setting would make old shell scripts which used Is 
almost certain losers. 
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NAME 
xref — lisp cross reference program 
SYNOPSIS 
beef [ -7 ] xref-file ... [—a source-file ... ] 
DESCRIPTION 
Lxref reads cross reference files written by the lisp compiler liszt and prints a cross reference listing on the 
standard output. 


With its —x option, liszt creates a cross reference file during compilation. Cross reference files usually end 
in ‘.x’; consequently, lxref appends a ‘.x’ to the filenames given if necessary. 


Lxref takes two options, which are described below. 


The first option to Ixref is a decimal integer, n, which sets the ignorelevel. If a function is called more than 
ignorelevel times, the cross reference listing will just print the number of calls instead of listing each one of 
them. The default for ignorelevel is 50. 


The second option follows the xref-files (cross reference files written by lisp) on the command line. The —a 
sourcefile option causes Lxref to put limited cross reference information in the sources named. Lxref scans 
the source and when it comes across a definition of a function (that is, a line beginning with ‘(def ), it pre- 
cedes that line with a list of the functions that call this function, written as a comment preceded by ‘;..’. 
All existing lines beginning with ‘;..’ will be removed from the file. A line beginning with ‘;.-’ in a source 
file disables this annotation process from this point on until a ‘;.+’ is seen (however, Lxref will continue to 
delete lines beginning with ‘;..’). After it has completed the annotation, Ixref changes the name of the ori- 
ginal file from ‘foo.!’ to ‘#,foo.l’. Lxref names the new file with annotation ‘foo.l’ . 


SEE ALSO 
lisp(1), liszt(1) 
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NAME 
m4 — macro processor 


SYNOPSIS 
m4 [ files ) 


DESCRIPTION 
M4 is a macro processor intended as a front end for Ratfor, C, and other languages. It processes each of 
the argument files in order. If there are no arguments, or if an argument is ‘—’, m4 reads the standard input. 
The processed text is written on the standard output. 


Macro calls have the form 

name(argi,arg2,..., argn) 
The ‘(’ must immediately follow the name of the macro. If a defined macro name is not followed by a ‘(’, 
m4 considers it to have no arguments. M4 ignores leading unquoted blanks, tabs, and newlines while col- 


lecting arguments. Potential macro names consist of alphabetic letters, digits, and underscore ‘_’, where 
the first character is not a digit. 


Left and right single quotes ( ’) are used to quote strings. The value of a quoted string 1 is the string stripped 
of the quotes. 


When m4 recognizes a macro name, it collects the macro’s arguments by searching for a matching right 
parenthesis. Macro evaluation proceeds normally during the collection of the arguments. Any commas or 
right parentheses which happen to turn up within the value of a nested call are as effective as those in the 
Original input text. After argument collection, m4 pushes the value of the macro back onto the input 
stream, then rescans the value. 


M4 Macros 


M4 makes available the following built-in macros. The macros may be redefined; once redefined, how- 
ever, the macros lose their original meanings. Their values are null unless otherwise stated. 


changequote 
Change quote characters to the first and second arguments. Changequote without arguments 
restores the original values (i.e., ~ ’). 


define Installs the second argument as the value of the macro whose name is the first argument. Each 
occurrence of $n in the replacement text, where x is a digit, is replaced by the n-th argument. 
Argument 0 is the name of the macro. Missing arguments are replaced by the null string. 


divert Changes the current output stream to its (digit-string) argument. M4 maintains 10 output 
streams, numbered 0-9. The final output is the concatenation of the streams in numerical 
order; initially stream 0 is the current stream. Output diverted to a stream other than 0 through 


9 is discarded. 
divnum _ Returns the value of the current output stream. 
dnl Reads and discards characters up to and including the next newline. 


dumpdef Prints current names and definitions, for the named items, or for all if no arguments are given. 
errprint Prints its argument on the diagnostic output file. 


eval Evaluates its argument as an arithmetic expression, using 32-bit arithmetic. meee include 
+,-, *, /, %, * (exponentiation); relationals; parentheses. 

ifdef Sets the value to the second argument if the first argument is defined; otherwise, m4 sets the 
value to the third argument. If there is no third argument, the value is null. The word unix is 
predefined on UNIX versions of m4. 


ifelse Takes three or more arguments. If the first argument is the same string as the second, then the 
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value is the third argument. If not, and if there are more than four arguments, the process is 


 fepeated with arguments 4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if it 


is not present, null. 
Returns the contents of the file named in the argument. 


_ Returns the value of its argument incremented by 1. The value of the argument is calculated 


by interpreting an initial digit-string as a decimal number. 
Returns the position in its first argument where the second argument begins (zero origin), or —1 
if the second argument does not occur. 


Returns the number of characters in its argument. 


maketemp Fills in a string of XXXXX in its argument with the current process id. 


sinclude 
substr 


syscmd 
translit 
undefine 


undivert 


SEE ALSO 


Is identical to include, except that it says nothing if the file is inaccessible. 


Returns a substring of its first argument. The second argument is a zero origin number select- 
ing the first character; the third argument indicates the length of the substring. A missing third 
argument is taken to be large enough to extend to the end of the first string. 


Executes the UNIX command given in the first argument. No value is returned. 
_ Transliterates the characters in its first argument from the set given by the second argument to 


the set given by the third. No abbreviations are permitted. 
Removes the definition of the macro named in its argument. 


Causes immediate output of text from diversions named as arguments. Without an argument, 
Causes output of text from all diversions. You can undivert the text into another diversion. 
Undiverting discards the diverted text. 


B. W. Kernighan and D. M. Ritchie, The M4 Macro Processor 
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NAME 
mail — send and receive mail 


SYNOPSIS 
mail [ options ] [—s subject ] { user ...] 
mail [ options } -f [ name } 
mail { options ] —u user 


INTRODUCTION 
Mail is a intelligent mail processing system, which has a command syntax reminiscent of ed with lines 
replaced by messages. 


Sending mail. To send a message to one or more people, mail can be invoked with arguments which are 
the names of people to whom the mail will be sent. You are then expected to type in your message, fol- 
lowed by an EOT (control—D) at the beginning of a line. A subject may be specified on the command line 
by using the —s flag. (Only the first argument after the —s flag is used as a subject; be careful to quote sub- 
jects containing spaces.) The section below, labeled Replying to or originating mail, describes some 
features of mail available to help you compose your letter. 


Reading mail. In normal usage mail is given no arguments and checks your mail out of the post office, 
then prints out a one line header of each message there. The current message is initially the first message 
(numbered 1) and can be printed using the print command (which can be abbreviated p). You can move 
among the messages much as you move between lines in ed, with the commands ‘+’ and ‘—’ moving back- 
wards and forwards, and simple numbers. 


Disposing of mail. After examining a message you can delete (d) the message or reply (r) to it. Deletion 
causes the mail program to forget about the message. This is not irreversible; the message can be 
undeleted (u) by giving its number, or the mail session can be aborted by giving the exit (x) command. 
Deleted messages will, however, usually disappear never to be seen again. 


Specifying messages. Commands such as print and delete can be given a list of message numbers as argu- 
ments to apply to a number of messages at once. Thus ‘‘delete 1 2’’ deletes messages 1 and 2, while 
“‘delete 1-5S’’ deletes messages 1 through 5. The special name ‘‘*’’ addresses all messages, and ‘‘$”’ 
addresses the last message; thus the command top which prints the first few lines of a message could be 
used in ‘‘top *’’ to print the first few lines of all messages. 


Replying to or originating mail. You can use the reply command to set up a response to a message, send- 
ing it back to the person who it was from. Text you then type in, up to an end-of-file, defines the contents 
of the message. While you are composing a message, mail treats lines beginning with the character *”’ 
specially. For instance, typing ‘‘““m’’ (alone on a line) will place a copy of the current message into the 
response right shifting it by a ais Other escapes will set up subject fields, add and delete recipients to 
the message and allow you to escape to an editor to revise the message or to a shell to run some commands. 
(These options are given in the summary below.) 


Ending a mail processing session. You can end a mail session with the quit (q) command. Messages 
which have been examined go to your mbox file unless they have been deleted in which case they are dis- 
carded. Unexamined messages go back to the post office. The —f option causes mail to read in the con- 
tents of your mbox (or the specified file) for processing; when you quit, mail writes undeleted messages 
back to this file. The —u flag is a short way of doing “mail —f /usr/spool/mail/user’ . 


Personal and systemwide distribution lists. It is also possible to create a personal distribution lists so that, 
for instance, you can send mail to ‘‘cohorts’’ and have it go to a group of people. Such lists can be defined 
by placing a line like 


alias cohorts bill ozalp i mark kridle@ucbcory 


in the file .mailrc in your home directory. The current list of such aliases can be displayed with the alias 
(a) command in mail. System wide distribution lists can be created by editing /usr/lib/aliases, see 
aliases(5) and sendmail(8); these are kept in a different syntax. In mail you send, personal aliases will be 
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expanded in mail sent to others so that they will be able to reply to the recipients. System wide aliases are 
not expanded when the mail is sent, but any reply returned to the machine will have the system wide alias 
expanded as all mail goes through sendmail. 


Network mail (ARPA, UUCP, Berknet) See mailaddr(7) for a description of network addresses. 


Mail has a number of options which can be set in the .maiirc file to alter its behavior; thus “set askcc” 
enables the ‘‘askcc’’ feature. (These options are summarized below.) 


OPTIONS 


-i Causes tty interrupt signals to be ignored. This option is useful when using mail on noisy phone 
lines. 


—n Inhibits the reading of /usr/lib/Mail.rc. 
-v Puts mail into verbose mode. Mail will display on the users terminal the details of delivery. 


COMMANDS 


(Adapted from the ‘Mail Reference Manual’) 


Each command is typed on a line by itself, and may take arguments following the command word. The 
command need not be typed in its entirety — the first command which matches the typed prefix is used. For 
commands which take message lists as arguments, if no message list is given, then the next message for- 
ward which satisfies the command’s requirements is used. If there are no messages forward of the current 
message, the search proceeds backwards, and if there are no good messages at all, mail types ‘No applica- 
ble messages’’ and aborts the command. 


- Goes to the previous message and prints it out. If given a numeric argument n, goes to the 
n-th previous message and prints it. 


v Prints a brief summary of commands. 

: Executes the UNIX shell command which follows. 

Print (P) Like print but also prints out ignored header fields. See also print , ignore and retain. 
Reply (R) Reply to originator. Does not reply to other recipients of the original message. 

Type (T) Identical to the Print command. 

alias | (a) With no arguments, prints out all currently-defined aliases. With one argument, prints 


out that alias. With more than one argument, creates an new or Changes an on old alias. 


alternates (alt) The alternates command is useful if you have accounts on several machines. It can be 
used to inform mail that the listed addresses are really you. When you reply to messages, 
mail will not send a copy of the message to any of the addresses listed on the alternates list. 

If the alternates command is given with no argument, the current set of alternate names is 


displayed. 

chdir (c) Changes the user’s working directory to that specified, if given. If no directory is given, 
then changes to the user’s login directory. 

copy (co) The copy command does the same thing that save does, except that it does not mark the 
messages it is used on for deletion when you quit. . 

delete (d) Takes a list of messages as argument and marks them all as deleted. Deleted messne 
will not be saved in mbox, nor will they be available for most other commands. 

dp (also dt) Deletes the current message and prints the next message. If there is no next mes- 

-. Sage, mail says ‘‘at EOF.’’ | 

edit (e) Takes a list of messages and points the text editor at each one in turn. On return from 
the editor, the message is read back in. 

exit (ex or x) Effects an immediate return to the Shell without modifying the user’s system 
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mailbox, his mbox file, or his edit file in -f. 
(fi) The same as folder. 
List the names of the folders in your folder directory. 


(fo) The folder command switches to a new mail file or folder. With no arguments, it tells 
you which file you are currently reading. If you give it an argument, it will write out 
changes (such as deletions) you have made in the current file and read in the new file. Some 
special conventions are recognized for the name. # means the previous file, % means your 
system mailbox, %user means user’s system mailbox, & means your ~/mbox file, and 
+folder means a file in your folder directory. 


(f) Takes a list of messages and prints their message headers. 


(h) Lists the current range of headers, which is an 18 message group. If a ‘‘+’’ argument is 
given, then the next 18 message group is printed, and if a ‘“‘—’’ argument is given, the previ- 
ous 18 message group is printed. 


A synonym for ? 


(ho, also preserve) Takes a message list and marks each message therein to be saved in the 
user’s system mailbox instead of in mbox. Does not override the delete command. 


N.B.: Ignore has been superseded by retain. 

Add the list of header fields named to the ignored list. Header fields in the ignore list are 
Not printed on your terminal when you print a message. This command is very handy for 
suppression of certain machine-generated header fields. The Type and Print commands can 
be used to print a message in its entirety, including ignored fields. If ignore is executed with 
no arguments, it lists the current set of ignored fields. 


(m) Takes as argument login names and distribution group names and sends mail to those 
people. 

Indicate that a list of messages be sent to mbox in your home directory when you quit. This 
is the default action for messages if you do not have the hold option set. 


(n like + or CR) Goes to the next message in sequence and types it. With an argument list, 
types the next matching message. 


(pre) A synonym for hold. 

(p) Takes a message list and types out each message on the user’s terminal. 

(q) Terminates the session, saving all undeleted, unsaved messages in the user’s mbox file in 
his login directory, preserving all messages marked with hold or preserve or never refer- 
enced in his system mailbox, and removing all other messages from his system mailbox. If 
new mail has arrived during the session, the message ‘‘You have new mail’’ is given. If 
given while editing a mailbox file with the —f flag, then the edit file is rewritten. A return to 
the Shell is effected, unless the rewrite of edit file fails, in which case the user can escape 
with the exit command. 

(r) Takes a message list and sends mail to the sender and all recipients of the specified mes- 
sage. The default message must not be deleted. 

A synonym for reply. 


Add the list of header fields named to the retained list. Only the header fields in the retain 
list are shown on your terminal when you print a message. All other header fields are 
suppressed. The Type and Print commands can be used to print a message in its entirety. 
If retain is executed with no arguments, it lists the current set of retained fields. 


(s) Takes a message list and a filename and appends each message in turn to the end of the 
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file. The filename in quotes, followed by the line count and character count is echoed on the 
user’s terminal. 

(se) With no arguments, prints all variable values. Otherwise, sets option. Arguments are 
of the form “‘option=value’’ (no space before or after =) or ‘‘option.”’ 

(sh) Invokes an interactive version of the shell. 

Takes a message list and prints out the size in characters of each message. 

(so) The source command reads mail commands from a file. 


Takes a message list and prints the top few lines of each. The number of lines printed is 
controlled by the variable toplines and defaults to five. 


(t) A synonym for print. 


Takes a list of names defined by alias commands and discards the remembered groups of 
users. The group names no longer have any significance. 


-(u) Takes a message list and marks each message as not being deleted. 


(U) Takes a message list and marks each message as not having been read. 
Takes a list of option names and discards their remembered values; the inverse of set. 
(v) Takes a message list and invokes the display editor on each message. 


(w) Similar to save, except that only the message body (without the header) is saved. | 
Extremely useful for such tasks as sending and receiving source program text over the mes- 
Sage system. 


(x) A synonym for exit. 


Mail presents message headers in windowfuls as described under the headers command. 
You can move mail’s attention forward to the next window with the z command. Also, you 
can move to the previous window by using z—. 


Here is a summary of the tilde escapes, which are used when composing messages to perform special func- 
tions. Tilde escapes are only recognized at the beginning of lines. The name ‘‘tilde escape’’ is somewhat 
of a misnomer since the actual escape character can be set by the option escape. 


“command Execute the indicated shell command, then return to the message. 


“b name ... 
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Add the given names to the list of carbon copy recipients but do not make the names visible 
in the Cc: line ("blind" carbon copy). 

Add the given names to the list of carbon copy recipients. 

Read the file ‘‘dead.letter’’ from your home directory into the message. 


Invoke the text editor on the message collected so far. After the editing session is finished, 
you may continue appending text to the message. 


Read the named messages into the message being sent. If no messages are specified, read in 
the current message. 


Edit the message header fields by typing each one in turn and allowing the user to append 
text to the end or modify the field by using the current terminal erase and kill characters. 


Read the named messages into the message being sent, shifted right one tab. If no messages 
are specified, read the current message. 


Print out the message collected so far, prefaced by the message header fields. 


Abort the message being sent, copying the message to ‘‘dead.letter’’ in your home directory 
if save is set. 
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Read the named file into the message. 
Cause the named string to become the current subject field. 
Add the given names to the direct recipient list. 


Invoke an alternate editor (defined by the VISUAL option) on the message collected so far. 
Usually, the alternate editor will be a screen editor. After you quit the editor, you may 
resume appending text to the end of your message. 


Write the message onto the named file. 


Pipe the message through the command as a filter. If the command gives no output or ter- 
minates abnormally, retain the original text of the message. The command fmt(1) is often 
used as command to rejustify the message. 


Insert the string of text in the message prefaced by a single ~. If you have changed the 
escape character, then you should double that character in order to send it. 


Options are controlled via the set and unset commands. Options may be either binary, in which case it is 
only significant to see whether they are set or not; or string, in which case the actual value is of interest. 
The binary options include the following: 


append 
ask 

askcc 
-autoprint 
debug 
dot 

hold 
ignore 
ignoreeof 
metoo 
nosave 
Replyall 


quiet 
verbose 


Causes messages saved in mbox to be appended to the end rather than prepended. (This 
is set in /usr/lib/Mail.rc on version 7 systems.) 


Causes mail to prompt you for the subject of each message you send. If you respond 
with simply a newline, no subject field will be sent. 


Causes you to be prompted for additional carbon copy recipients at the end of each mes- 
sage. Responding with a newline indicates your satisfaction with the current list. 


Causes the delete command to behave like dp — thus, after deleting a message, the next 
one will be typed automatically. 


Setting the binary option debug is the same as specifying —d on the command line and 
causes mail to output all sorts of information useful for debugging mail. 


The binary option dot causes mail to interpret a period alone on a line as the terminator 
of a message you are sending. 


This option is used to hold messages in the system mailbox by default. 
Causes interrupt signals from your terminal to be ignored and echoed as @’s. 


An option related to dot is ignoreeof which makes mail refuse to accept a control-d as 
the end of a message. /gnoreeof also applies to mail command mode. 


Usually, when a group is expanded that contains the sender, the sender is removed from 
the expansion. Setting this option causes the sender to be included in the group. 


Normally, when you abort a message with two RUBOUT, mail copies the partial letter to 
the file ‘‘dead.letter’’ in your home directory. Setting the binary option nosave prevents 
this. 


Reverses the sense of reply and Reply commands. 
Suppresses the printing of the version when first invoked. 


Setting the option verbose is the same as using the —v flag on the command line. When 
mail runs in verbose mode, the actual delivery of messages is displayed on he users ter- 
minal. 


The following options have string values: 


EDITOR 


May 9, 1986 
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| _ then a default editor is used. 
PAGER Pathname of the program to use in the more command or when crt variable is set. A 
default paginator is used if this option is not defined. 
SHELL Pathname of the shell to use in the ! command and the “! escape. A default shell is used 
if this option is not defined. . 
VISUAL Pathname of the text editor to use in the visual command and “v escape. 
crt The valued option crt is used as a threshold to determine how long a message must be 
before PAGER is used to read it. 
escape If defined, the first character of this option gives the character to use in the place of ~ to 
denote escapes. 
folder The name of the directory to use for storing folders of messages. If this name begins 
with a ‘/’, mail considers it to be an absolute pathname; otherwise, the folder directory is 
found relative to your home directory. | 
record If defined, gives the pathname of the file used to record all outgoing mail. If not defined, 
then outgoing mail is not so saved. 
toplines If defined, gives the number of lines of a message to be printed out with the top com- 
mand; normally, the first five lines are printed. 
FILES 
/ust/spool/mail/* post office 
“/mbox your old mail 
“/.mailrc file giving initial mail commands 
/tmp/R# temporary for editor escape 
/ust/lib/Mail.help* help files 
/usr/lib/MailL.rc system initialization file 
Message* temporary for editing messages 
SEE ALSO 
binmail(1), fmt(1), newaliases(1), aliases(S), mailaddr(7), sendmail(8) 
‘The Mail Reference Manual’ 
BUGS 


There are many flags that are not documented here. Most are not useful to the general user. 


Usually, mail is ju 
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NAME 

make — maintain program groups 
SYNOPSIS 

make [ -f makefile ] [ options ] file ... 
DESCRIPTION 


Make executes commands in makefile to update one or more target names. Name is typically a program. 
If no —f option is present, ‘makefile’ and ‘Makefile’ are tried in order. If makefile is ‘—’, the standard input 
is taken. More than one -f option may appear. 


Make updates a target if it depends on prerequisite files that have been modified since the target was last 
modified, or if the target does not exist. 


‘Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a blank- 
separated list of targets, then a colon, then a list of prerequisite files. Text following a semicolon, and all 
following lines that begin with a tab, are shell commands to be executed to update the target. If a name 
appears on the left of more than one ‘colon’ line, it depends on all of the names on the right of the colon on 
those lines, but only one command sequence may be specified for it. If a name appears on a line with a 
double colon ::, the command sequence following that line is performed only if the name is out of date 
with respect to the names to the right of the double colon, and is not affected by other double colon lines on 
which that name may appear. 


Make recognizes two special forms of a name. A name like a(b) means the file named b stored in the 
archive named a. A name like a((b)) means the file stored in archive a containing the entry point b. 


Sharp and newline surround comments. 


The following makefile says that ‘pgm’ depends on two files ‘a.o’ and ‘b.o’, and that they in tum depend 
on ‘.c’ files and a common file ‘incl’. 


pgm: 2.0 b.o 

cc a.0 b.o —lm —o pgm 
a.o: incl a.c 

cc -C ac 
b.o: incl b.c 

cc —c b.c 


Makefile entries of the form 

String 1 = string2 
are macro definitions. Subsequent appearances of $(string]) or ${string]} are replaced by string2. If 
String] is a single character, the parentheses or braces are optional. 


Make infers prerequisites for files for which makefile gives no construction commands. For example, a ‘.c’ 
file may be inferred as prerequisite for a ‘.o’ file and be compiled to produce the ‘.o’ file. Thus the preced- 
ing example can be done more briefly: : 

pgm: a.0 b.o 


cc a.0 b.o —lm —o pgm 
a.o b.o: incl 


Make infers prerequisites according to selected suffixes listed as the ‘prerequisites’ for the special name 
* SUFFIXES’; multiple lists accumulate; an empty list clears what came before. Order is significant; the 
first possible name for which both a file and a rule as described in the next paragraph exist is inferred. The 
default list is | 


SUFFIXES: .out .0 .c .e rf -y 1.8 .p 
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The rule to create a file with suffix s2 that depends on a similarly named file with suffix s/ is specified as an 
entry for the ‘target’ s]s2. In such an entry, the special macro $* stands for the target name with suffix 


deleted, $@ for the full target name, $< for the complete list of prerequisites, and $? for the list of prere- 


quisites that are out of date. For example, a rule for making optimized ‘.o’ files from ‘.c’ files is 
C0: ; cc -C -O —0 $@ $*.c . 


The default inference rules uses certain macros to communicate optional arguments to any resulting compi- 
lations. In particular, the rules uses ‘CFLAGS’ for ce(1) options, ‘FFLAGS’ for f77(1) options, ‘PFLAGS’ 
for pc(1) options, and ‘LFLAGS’ and ‘YFLAGS’ for lex and yacc(1) options. In addition, the macro 
‘MFLAGS’ is filled in with the initial command line options supplied to make. This simplifies maintaining 
a hierarchy of makefiles as one may then invoke make on makefiles in subdirectories and pass along useful 
options such as —k. 


Another special macro is ‘VPATH’. The ‘VPATH’ macro should be set to a list of directories separated by 
colons. When make searches for a file as a result of a dependency relation, it will first search the current 
directory and then each of the directories on the ‘VPATH’ list. If make finds the file, it will use the actual 
path to the file, rather than just the filename. If “VPATH’ is not defined, make searches only the current 
directory for the file. 


“VPATH’ is useful when you have several programs that compile from the same source. You can keep the 
source in one directory and each set of object files (along with a separate makefile) in a separate subdirec- 
tory. The ‘VPATH’ macro would point to the source directory in this case. 


Command lines are executed one at a time, each by its own shell. A line is printed when it is executed 
unless the special target ‘SILENT’ is in makefile, or the first character of the command is ‘@’. 


Commands returning nonzero status (see intro(1)) cause make to terminate unless the special target 
‘IGNORE’ is in makefile or the command begins with <tab><hyphen>. 


Interrupt and quit delete the target unless the target is a directory or depends on the special name ‘.PRE- 
CIOUS’. 


OPTIONS 


FILES 


-i Is equivalent to the special entry ‘.IGNORE:’. 


—k When a command returns nonzero status, abandons work on the current entry, but continues on 
branches that do not depend on the current entry. 


—n Traces and prints, but does not execute the commands needed to update the targets. 
-r Is equivalent to an initial special entry ‘“.SUFFIXES:’ with no list. 

—S Is equivalent to the special entry ‘.SILENT:’. . 

-t Touches, i.e., updates, the modified date of targets, without executing any commands. 


makefile, Makefile 


SEE ALSO 


BUGS 


sh(1), touch(1), £77(1), pe(1) 
S. I. Feldman Make — A Program for Maintaining Computer Programs 


Some commands return nonzero status inappropriately. Use —i to overcome the difficulty. 
Commands that are directly executed by the shell, notably cd(1), are ineffectual across newlines in make. 


*‘VPATH?’ is intended to act like the System V ‘VPATH’ support, but there is no guarantee that it functions 
identically. | 
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NAME 


man — find manual information by keywords; print out the manual 


SYNOPSIS 


man [—][-—p] [-t][—M path] [ section ] title ... 
man —k keyword ... 
man —f file ... 


DESCRIPTION 


Man gives information from the programmers manual. It can be asked for one line descriptions of com- 
mands specified by name, or for all commands whose description contains any of a set of keywords. It can 
also provide on-line access to the sections of the printed manual. 


When neither —k nor —f is specified, man formats a specified set of manual pages. If a section specifier is 
given, man looks in the that section of the manual for the given titles. Section is either an Arabic section 
number (3 for instance), or one of the words ‘‘new,”’ “‘local,’’ “‘old,’’ or ‘‘public.’’ A section number 
may be followed by a single letter classifier (for instance, 1g, indicating a graphics program in section 1). 
If section is omitted, man searches all sections of the manual, giving preference to commands over subrou- 
tines in system libraries, and printing the first section it finds, if any. 


If the standard output is a teletype, man formats its output as though you had specified the — option. See 
the OPTIONS section below. 


Man looks for the manual page in either of two forms, the nroff source or preformatted pages. If either 
version is available, man displays the manual page. Man displays the preformatted version if it is available 
and it has a more recent modify time than the nroff source. Otherwise, man formats the manual page with 
nroff and displays it. If the user has permission, the formatted manual page will be deposited in the proper 
place, so that later invocations of man will not need to format the page again. 


OPTIONS 


FILES 


- Pipes man’s output through more(1) with the —s option to crush out useless blank lines and to 
stop after each page on the screen. When the output stops, hit a space to continue or a control-D 
to scroll 11 more lines. 


-f filenames 
Attempts to locate manual sections related to those files, printing out the table of contents lines for 
those sections. 


—k keywords 
Prints out a one line synopsis of each manual sections whose listing in the table of contents con- 
tains one of those keywords. | 


—M path 
Supplies a search path (in the shell) that man will use to look for manual information. Normally 
man checks in a standard location for manual information (/usr/man). The search path is a colon 
(‘:’) separated list of directories in which manual subdirectories may be found; e.g. 
**/ust/local:/usr/man’’. If the environment variable ‘MANPATH?’ is set, its value is used for the 
default path. When specify a search path with the with the —k and -f options, specify the path 
first, then the —k or —f flag and arguments. 

—p section | 
Troffs the specified section to a window. This option overrides —t. Man ignores —p if the stan- 
dard ouput for man is not a window. 


-t Troffs the specified section to a suitable raster output device. 


/usr/man standard manual area 
/usr/man/man?/* directories containing source for manuals 
/usr/man/cat?/* directories containing preformatted pages 
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fusr/man/whatis keyword database 


SEE ALSO 
apropos(1), more(1), whereis(1), catman(8) 


BUGS 
The manual is supposedly reproducible on either a phototypesetter or a typewriter. However, some infor- 
mation is necessarily lost when the manual is reproduced on a typewriter. 
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NAME 
mesg — permit or deny messages 
SYNOPSIS 
mesg [ options ] 
DESCRIPTION 
Mesg lets the user enable or disable messages via write and talk(1) by revoking or reinstating non-user 


write permission on the user’s terminal. Without an argument, mesg reports the current state of non-user 
write permission without changing it. 


OPTIONS . 
n Forbids messages via write and talk(1) by revoking non-user write permission to the user’s termi- 
nal. . 
y Reinstates non-user write permission to the user’s terminal. 
FILES 
/devitty* 
SEE ALSO 
write(1), talk(1) 
DIAGNOSTICS 


Exit status is 0 if messages are receivable, 1 if not, or 2 on error. 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


MKDIR(1) _ _ UNIX Programmer’s Manual / MKDIR (1) 


NAME 

mkdir — make a directory 
SYNOPSIS 

mkdir dirname ... 


DESCRIPTION 
Mkdir creates specified directories in mode 777. It automatically generates standard entries—that is, ‘. 
for the directory itself, and ‘..’ for its parent. 


Mkdir requires write permission in the parent directory. 


SEE ALSO 
rmdir(1) 
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NAME 
mkstr — create an error message file by massaging C source 
SYNOPSIS 
mkstr [ option | messagefile prefix file ... 
DESCRIPTION 
Mkstr creates files of error messages. It can substantially reduce the size of programs with large numbers 
of error diagnostics. It can also reduce system overhead in running the program since the error messages 
do not have to be constantly swapped in and out. 
Mkstr processes each of the specified files, placing a massaged version of the input file in a file whose 
name consists of the specified prefix and the original name. A typical usage of mkstr would be 
mkstr pistrings xx *.c 
This command would cause all the error messages from the C source files in the current directory to be 
placed in the file pistrings and processed topies of the source for these files to be placed in files whose 
names are prefixed with xx. 
To process the error messages in the source to the message file mkstr keys on the string ‘error("’ in the 
input stream. Each time it occurs, the C string starting at the ‘"’ is placed in the message file followed by a 
null character and a new-line character; the null character terminates the message so it can be easily used 
when retrieved, the new-line character makes it possible to sensibly cat the error message file to see its 
contents. The massaged copy of the input file then contains a Iseek pointer into the file which can be used 
to retrieve the message, i.e.: 
char — efilname[] = "/usr/lib/pi_strings"; 
int efil = -1; 
error(al, a2, a3, a4) 
ts 
char buf[256]; 
if (efil < 0) { 
efil = open(efilname, 0); 
if (efil < 0) { 
oops: 
perror(efilname); 
exit(1); 
} 
} 
if (Iseek(efil, (long) al, 0) || read(efil, buf, 256) <= 0) 
goto oops; 
printf(buf, a2, a3, a4); 
} 
OPTIONS 
- Places the error messages at the end of the specified message file for recompiling part of a large 
mkstr ed program. 
SEE ALSO 


Iseek(2), xstr(1) 
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NAME 
more, page — file perusal filter for crt viewing 


SYNOPSIS 
more [ options ] [ filename ... ] 


page [ options ] [ filename ... ] 

' DESCRIPTION | . 
More is a filter which allows examination of a continuous text one screenful at a time on a soft-copy termi- 
nal. It normally pauses after each screenful, printing --More-- at the bottom of the screen. If you then type 
@ Catriage return, more scrolls the screen and displays the next line of text. If you press the space bar, 
more displays the next screenful of text. Other possibilities are enumerated later. 

Page is identical to more except that it clears the screen before printing each screenful of text (when it 
prepares to print a full screenful of text). Also, it prints k — 1 rather than k — 2 lines in each screenful, 
where k is the number of lines the terminal can display. 


More looks in the file /etc/termcap to determine terminal characteristics, and to determine the default win- 
dow size. On a terminal capable of displaying 24 lines, the default window size is 22 lines. 


More looks in the environment variable MORE to pre-set any flags desired. For example, if you prefer to 
view files using the —c mode of operation, the csh command setenv MORE -c or the sh command 
sequence MORE=’-c’ ; export MORE would cause all invocations of more, including invocations by 
programs such as man and msgs , to use this mode. Normally, you would place the command sequence 
that sets up the MORE environment variable in the .cshrc or -profile file. 


When more is reading from a file, rather than a pipe, it diplays a percentage along with the --More-- 
prompt. The percentage tells what fraction of the file (in characters, not lines) that more has read so far. 


If the standard output is not a teletype, then more acts just like cat, except that a header is printed before 
each file (if there is more than one). 


A sample usage of more in previewing nroff output would be 
nroff —ms +2 doc.n | more -s 


COMMANDS 
Other sequences you can type when more pauses, and their effects, are described below. (i is an optional 
integer argument, defaulting to 1.) 


i <space> 
Displays i more lines, (or another screenful if no argument is given) 


i/expr Searches for the i-th occurrence of the regular expression expr. If there are less than i 
occurrences of expr , and the input is a file (rather than a pipe), then the position in the file remains 
unchanged. Otherwise, more displays a screenful of text, starting two lines before the place 
where the expression was found. The user can use the erase and kill characters to edit the regular 
expression. Erasing back past the first column cancels the search command. 


ib Skips back i screenfuls and prints a screenful of lines. 

i‘B Performs the same function as b. 

if Skips i screenfuls and prints a screenful of lines. 

in __ Searches for the i-th occurrence of the last regular expression entered. 

is Skips i lines and prints a screenful of lines. 

iz Performs the same function as typing a space except that i, if present, becomes the new window 
size. 
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in Skips to the 7-th next file given in the command line (skips to last file if n doesn’t make sense). 


i:p Skips to the i-th previous file given in the command line. If you invoke this command in the mid- 
dle of printing a file, more goes back to the beginning of the file. If i doesn’t make sense, more 
skips back to the first file. If more is not reading from a file, the command rings the bell and does 


nothing else. 
“‘D Displays 11 more lines (a ‘‘scroll’’). If you specify i, more sets the scroll size toi. 
d Performs the same function as “D (control-D). 
h Prints a description of all the more commands. This is the help command. 
qorQ_ Exits from more. 
v Starts up the editor vi at the current line. 


if Displays the current filename and line number. 
:q or :Q Exits from more (same as q or Q). 


!command 
Invokes a shell with command. The characters ‘%’ and ‘!’ in "command" are replaced with the 
current filename and the previous shell command respectively. If there is no current filename, ‘%’ 
is not expanded. The sequences "\%" and "\!" are replaced by "%" and "!" respectively. 


= Displays the current line number. 


(single quote) Goes to the point from which the last search started. If no search has been per- 
formed in the current file, this command goes back to the beginning of the file. 


(dot) Repeats the previous command. 


The commands take effect immediately—it is not necessary to type a Catriage return. Until you type the 
command character itself, you can type the line kill character to cancel the numerical argument being 
formed. In addition, you can type the erase character to redisplay the --More--(xx%) message. 


At any time when more is sending output to the terminal, you can press the quit key (normally control-\). 
More will stop sending output, and will display the usual --More-- prompt. You may then enter one of the 
above commands in the normal manner. Unfortunately, some output is lost when this is done, because 
more flushes any characters waiting in the terminal’s output queue when it receives the quit signal. 


More sets the terminal to noecho mode to allow continuous output. What you type will not show on your 
terminal, except for the / and ! commands. 


OPTIONS 

—C Draws each page by beginning at the top of the screen and erasing each line just before writing on 
it. This avoids scrolling the screen and makes it easier to read while more is writing. More will 
ignore this option if the terminal does not have the ability to clear to the end of a line. 


~-d Prompts you with the message "Press space to continue, “q’ to quit." at the end of each screenful, 
and responds to subsequent illegal user input by printing "Press “h’ for instructions." instead of 
ringing the bell. This option is useful if you are using more as a filter in some setting, such as a 
classroom, where many users may be unsophisticated. 


-f Causes more to count logical, rather than screen lines. That is, -f causes more not to fold long 
lines. This option is recommended if you are piping nroff output through ul, since ul may gen- 
erate escape sequences. These escape sequences contain characters which would ordinarily 
occupy screen positions, but which do not print when more sends them to the screen as part of an 
escape sequence. Reading these characters, more might overestimate the length of these lines and 
fold them erroneously. 


—] Does not treat “L (form feed) specially. If you do not specify this option, more will pause after 
_. any line that contains a “L, as though it has reached the bottom of the screen. Also, if a file begins 
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with a form feed, more will clear the screen before printing the file. 


—s Squeezes multiple blank lines from the output, producing only one blank line. Especially helpful 
when viewing nroff output, this option maximizes the useful information present on the screen. 
—u Normally, more will handle underlining such as produced by nroff in a manner appropriate to the 
particular terminal: if the terminal can perform underlining or has a stand-out mode, more will 
Output appropriate escape sequences to enable underlining or stand-out mode for underlined infor- 
mation in the source file. The —u option suppresses this processing. 
~—n ___ Sets the size (in lines) of the window more will use instead of the default. 
+linenumber 
Starts up at linenumber. 
+/pattern 
Starts up two lines before the line containing the regular expression pattern. 
FILES 
/etc/termcap Terminal data base 
/usr/lib/more.help Help file 
SEE ALSO 


csh(1), man(1), msgs(1), script(1), sh(1), environ(7) 


BUGS 


Skipping backwards is too slow on large files. 


June 5, 1986 


INTEGRATED SOLUTIONS 4.3 BSD 3 


MSET(1) UNIX Programmer’s Manual MSET (1) 


NAME 
mset — retrieve ASCII to IBM 3270 keyboard map 


SYNOPSIS 
mset 


DESCRIPTION 
Mset retrieves mapping information for the ASCII keyboard to IBM 3270 terminal special functions. Nor- 
mally, these mappings are found in /etc/map3270 (see map3270(5)). This information is used by the 
tn3270 command (see tn3270(1)). 


You can use mset to store the mapping information in the process environment in order to avoid scanning 
/etc/map3270 each time tn3270 is invoked. To do this, place the following command in your 


set noglob; setenv MAP3270 "’mset'"; unset noglob 


Mset first determines the user’s terminal type from the environment variable TERM. Normally mset then 
uses the file /etc/map3270 to find the keyboard mapping for that terminal. However, if the environment 
variable MAP3270 exists and contains the entry for the specified terminal, then mset uses that definition. 
If the value of MAP3270 begins with a slash (‘/’), it is assumed to be the full pathname of an alternate 
mapping file and that file is searched first. In any case, if the mapping for the terminal is not found in the 
environment, nor in an alternate map file, nor in the standard map file, then the same search is performed 
for an entry for a terminal type of unknown. If that search also fails, a default mapping is used. 


FILES 

/etc/map3270 keyboard mapping for known terminals 
SEE ALSO 

tn3270(1), map3270(5) 


BUGS 
If the entry for the specific terminal exceeds 1024 bytes, csh(1) will fail to set the environment variable. 
Mset should probably detect this case and output the path to the map3270 file instead of the terminal entry. 
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NAME 
msgs — system messages and junk mail program 


SYNOPSIS 
msgs [ —fhipq ] [ nwmber ] [ —number ] 


msgs -s 
msgs —c [ —days ] 


DESCRIPTION ; 
Msgs is used to read system messages. These messages are sent by mailing to the login ‘msgs’ and should 
be short pieces of information which are suitable to be read once by most users of the system. 


You can invoke msgs each time you login by placing it in the file login (.profile if you use /bin/sh). When 
invoked, msgs prompts you with the source and subject of each new message. If there is no subject line, 
msgs displays the first few non-blank lines of the message. If there is more to the message, msgs tells you 
how long it is and asks you whether you wish to see the rest of the message. The possible responses appear 
in the COMMANDS section below. : 


Msgs keeps track of the next message you will see by a number in the file msgsrc in your home directory. 
In the directory /usr/msgs it keeps a set of files whose names are the (sequential) numbers of the messages 
they represent. The file /usr/msgs/bounds shows the low and high number of the messages in the directory 
so that msgs can quickly determine if there are no messages for you. If the contents of bounds is incorrect, 
you can fix the problem by removing the file; msgs will make a new bounds file the next time it is run. 


Within msgs you can go to any specific message by typing its number when msgs requests input as to what 


to do. 
COMMANDS 

- _ Redisplays the last message. 

<RETURN> 
Performs the same function as y. 

m or m— . 

Causes a copy of the specified message to be placed in a temporary mailbox and mail(1) to be 
invoked on that mailbox. Both m and s accept a numeric argument in place of the ‘—’. 

Skips the current message and proceeds to the next message. 

Exits msgs. The next time you run msgs it will pick up where you left off. 

s Appends the current message to the file ‘“Messages’’ in the current directory. s- saves the previ- 
ously displayed message. If you follow s or s- with a space and a filename, msgs writes the mes- 
sage into the specified file rather than into the default ‘‘Messages’’. 

y Types the rest of the message. 

OPTIONS 


Options when reading messages include: 


-f Suppresses the message ‘“No new messages.” when there are no system messages. This option is 
useful in your login file since often there are no messages. 


-h Causes msgs to print the first part of messages only. 
-l Causes only locally originated messages to be reported. 
—p Causes long messages to be piped through more(1). © 


-—q Queries whether there are messages, printing ““There are new messages.’’ if there are. The com- 
mand ‘‘msgs —q’’ is often used in login scripts. 


number Causes msgs to start at the message whose number is nwmber rather than at the next message 
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indicated by your .msgsrc file. Thus 
msgs —h 1 
prints the first part of all messages. 


~—number 
Causes msgs to start number messages back from the one indicated by your .msgsrc file, useful for 
reviews of recent messages. 


Other options include: 


—c [ -days } 
Performs cleanup on /usr/msgs. An entry with the —c option should be placed in /usr/lib/crontab 
to run every night. This will remove all messages over 21 days old. You can set a different 
expiration on the command line to override the default. 


—S Sets up the posting of messages. The line 
msgs: "| /usr/ucb/msgs —s" 
should be included in /usr/lib/aliases to enable posting of messages. 


FILES 

/ust/msgs/* database 

“/.msgsrc number of next message to be presented 
SEE ALSO 


aliases(5), crontab(5), mail(1), madrecd) 
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NAME 

mt — magnetic tape manipulating program 
SYNOPSIS 

mt [ —f tapename ] command [ count } 


DESCRIPTION | | | 
Mt lets you give commands to a magnetic tape drive. If you do not specify a tapename, mt uses the 
environment variable TAPE. If TAPE does not exist, mt uses the device /dev/rmt12 . Note that tapename 
must refer to a raw (not block) tape device. . 


By default mt performs the requested operation once. To perform an operation multiple times, specify 
count. 


The available commands are listed below. You need to specify only as many characters as are required to 
uniquely identify a command. 


eof, weof 
Write count end-of-file marks at the current position on the tape. 


fsf Forward space count files. 

fsr Forward space count records. 

bsf Back space count files. 

bsr Back space count records. 

rewind Rewind the tape (Count is ignored). 


offline, rewoffl 
Rewind the tape and place the tape unit off-line (Count is ignored). 
status Print status information about the tape unit. 


Mt returns a 0 exit status if the Operations were successful, 1 if a command was unrecognized, or 2 if an 
operation failed. 
FILES : | 
/dev/rmt* Raw magnetic tape interface 
SEE ALSO 
mtio(4), dd(1), ioctIT(2), environ(7) 
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NAME 
mv — move or rename files 


SYNOPSIS 
mv [ options ] file] file2 
mv [ options } file ... directory 
DESCRIPTION 
Mv moves (changes the name of ) file! to file2. 


— If file2 already exists, mv removes it before moving file]. If file2 has a mode which forbids writing, mv 
prints the mode and waits for a response from the user on the standard input. (See chmod(2).) If the 
user’s respone begins with y, mv executes the move; if not, mv exits. 


In the second form listed in the SYNOPSIS, mv moves one or more files (plain files or directories) to the 
directory without altering their original filenames. 
Mv refuses to move a file onto itself. 
OPTIONS 
- Interprets all the following arguments to mv as filenames. This option lets the move or rename 
filenames that start with minus. | 
—f Overrides any mode restrictions or the —-i switch. (Force.) 


-i Puts my in interactive mode. Whenever a move is to supercede an existing file, mv prompts the 
user with the filename followed by a question mark. If the user answers with a line starting with 
*y’, the move continues. Any other reply cancels the move. 
SEE ALSO 
cp(1), In(1) 
BUGS 
If file] and file2 lie on different file systems, mv must copy the file and delete the original. In this case the 
owner name becomes that of the copying process and any linking relationship with other files is lost. 
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NAME 
netstat — show network status 


SYNOPSIS . . 
netstat [ —Aan ] [-f address family ][ system] [ core ] 
netstat [ —himnrs ] [ -f address_family } [ system ][ core ] 
netstat [ —n } [ —I interface ] interval [ system} [ core } 


DESCRIPTION 
The netstat command symbolically displays the contents of various network-related data structures. There 
are a number of output formats, depending on the options for the information presented. The first form of 
the command displays a list of active sockets for each protocol. The second form presents the contents of 
one of the other network data structures according to the option selected. Using the third form, with an 
interval specified, netstat will continuously display the information regarding packet traffic on the 
configured network interfaces. 


The arguments, system and core allow substitutes for the defaults “‘7ymunix”’ and ‘‘/dev/kmem’’. 


The default display for active sockets shows the local and remote addresses, send and receive queue sizes 
(in bytes), protocol, and the internal state of the protocol. Address formats are of the form ‘‘host.port’’ or 
“*network.port’’ if a socket’s address specifies a network but no specific host address. When known the 
host and network addresses are displayed symbolically according to the data bases /etc/hosts and 
/etc/networks , respectively. If a symbolic name for an address is unknown, or if the —n option is specified, 
the address is printed numerically, according to the address family. For more information regarding the 
Internet ‘‘dot format,’’ refer to inet(3N). Unspecified or ‘‘wildcard’’ addresses and ports appear as ‘‘*’’. 


The interface display provides a table of cumulative statistics regarding packets transferred, errors, and col- 
lisions. The network addresses of the interface and the maximum transmission unit (‘‘mtu’’) are also 
displayed. . 


The routing table display indicates the available routes and their status. Each route consists of a destination 
host or network and a gateway to use in forwarding packets. The flags field shows the state of the route 
(‘‘U”’ if “‘up’’), whether the route is to a gateway (‘‘G’’), and whether the route was created dynamically 
by a redirect (‘‘D’’). Direct routes are created for each interface attached to the local host; the gateway 
field for such entries shows the address of the outgoing interface. The refcnt field gives the current number 
of active uses of the route. Connection oriented protocols normally hold on to a single route for the dura- 
tion of a connection while connectionless protocols obtain a route while sending to the same destination. 
The use field provides a count of the number of packets sent using that route. The interface entry indicates 
the network interface utilized for the route. 


When netstat is invoked with an interval argument, it displays a running count of statistics related to net- 
work interfaces. This display consists of a column for the primary interface (the first interface found dur- 
ing autoconfiguration) and a column summarizing information for all interfaces. The primary interface 
may be replaced with another interface with the —I option. The first line of each screen of information con- 
tains a summary since the system was last rebooted. Subsequent lines of output show values accumulated 


over the preceding interval. 
OE ONS 
-A With the default display, show the address of any protocol control blocks associated with sockets; 
used for debugging. 
—a _— With the default display, show the state of all sockets; normally sockets used by server processes 
are not shown. 
—f address_family 


Limits statistics or address control block reports to those of the specified address family. The fol- 
lowing address families are recognized: inet, for AF_INET, ms, for AF_NS, and unix, for 
AF UNIX. | 
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—h - Shows the state of the IMP host table. 


-i Shows the state of interfaces which have been auto-configured (interfaces statically configured 
into a system, but not located at boot time are not shown). 

-I interface 
Shows information only about this interface; used with an interval as described below. 


—m Shows statistics recorded by the memory management routines (the network manages a private 
pool of memory buffers). 


—n Shows network addresses as numbers (normally netstat interprets addresses and attempts to 
display them symbolically). This option may be used with any of the display formats. 


-r Shows the routing tables. When —s is also present, shows routing statistics instead. 
-s Shows per-protocol statistics. 
SEE ALSO 


iostat(1), vmstat(1), hosts(5), networks(5), protocols(5), services(5), trpt(8C) 


BUGS 
The notion of errors is ill-defined. Collisions mean something else for the IMP. 
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NAME 
newaliases — rebuild the data base for the mail aliases file 
SYNOPSIS 
newaliases 
DESCRIPTION 


Newaliases rebuilds the random access data base for the mail aliases file /usr/lib/aliases. Newaliases must 
be run each time /usr/lib/aliases is changed in order for the change to take effect. 


SEE ALSO 
aliases(S), sendmail(8) 
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NAME 
nice, nohup — run a command at low priority (sh only) 


SYNOPSIS © 
nice [ —nwnber ] command [{ arguments | 
nohup command [ arguments ] 

DESCRIPTION 
Nice executes the specified command with low scheduling priority. If the number argument is present, nice 
increments the priority by that amount up to a limit of 20. Higher numbers mean lower priorities. The 
default number is 10. 
The super-user may run commands with priority higher than normal by using a negative priority, e.g., 
‘—~10’. 
Nohup executes the specified command immune to hangup and terminate signals from the controlling ter- 
minal and increments the command’s pridtity by 5. Nohup should be invoked from the shell with ‘&’ in 
order to prevent it from responding to interrupts by or stealing the input from the next person who logs in 
on the same terminal. 

FILES 
nohup.out standard output and standard error file under nohup 

SEE ALSO 
csh(1), setpriority(2), renice(8) 

DIAGNOSTICS 
Nice returns the exit status of the subject command. | 

BUGS 
Nice and nohup are particular to sh(1). If you use esh(1), commands executed with ‘‘&’’ are automati- 
cally immune to hangup signals while in the background. There is a built-in command nohup which pro- 
vides immunity from terminate, but it does not redirect output to nohup.out. 


Nice is built into csh(1) with a slightly different syntax than described here. The form ‘‘nice +10’’ nices to 
positive nice, and ‘‘nice -10’’ can be used by the super-user to give a process more of the processor. 
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NAME 

mm — print name list 
SYNOPSIS ~~ 
nm [ options ] [ file ... ] 
_ DESCRIPTION . 
Nm prints the name list (symbol table) of each object file in the argument list. If an argument is an archive, 
a listing for each object file in the archive will be produced. If no file is given, the symbols in a.out are 
listed. 
Each symbol name is preceded by its value (blanks if undefined) and one of the following letters: 
Debugger symbol table entries (see —a below). 


A Absolute 

B Bss segment symbol 
C Common symbol 

D Data segment symbol 
f filename 

T Text segment symbol 


U Undefined 


If the symbol is local (non-external), the type letter appears in lower case.. Nm sorts the output alphabeti- 
cally. 


OPTIONS 
—a Prints symbol table entries inserted for use by debuggers. 


—g Prints only global (external) symbols. 
—n Sorts numerically rather than alphabetically. 


—O Prepends file or archive element name to each output line rather than only once. 
—p Cancels the sorting operation. Prints in symbol-table order. 
-r Sorts in reverse order. . 
—u Prints only undefined symbols. 
SEE ALSO 


ar(1), ar(5), a.out(5), stab(5) 
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NAME 


nroff — text formatting 


SYNOPSIS 


nroff { options J { files } 


DESCRIPTION 


Nroff formats text in the named files for typewriter-like devices. See also troff(1). The full capabilities of 
proff are described in the Nroff/Troff User's Manual. 

If you do not specify a file, mroff reads the standard input. An argument consisting of a single minus (—) is 
taken to be a filename corresponding to the standard input. 


OPTIONS 


The options, which may appear in any order so long as they appear before the files, are: 
—e Produces equally-spaced words in adjusted lines, using full terminal resolution. 


—h Uses output tabs during horizontal spacing to speed output and reduce output character count. 
Tab settings are assumed to be every 8 nominal character widths. 

-i Reads standard input after the input files are exhausted. 

—mname 


Prepends the macro file /usr/lib/tmac/tmac.name to the input filles. 
—nN Numbers the first generated page N. 


-olist Prints only pages whose page numbers appear in the comma-separated list of numbers and 
ranges. A range N—M means pages N through M; an initial -N means from the beginning to page 
N; and a final N— means from N to the end. 


—q Invokes the simultaneous input-output mode of the rd request. 
-raN _ Sets register a (one-character) to N. 


—sN __ Stops every N pages. Nroff will halt prior to every N pages (default N=1) to allow paper loading 
or changing, and will resume upon receipt of a newline. 
~Tname Prepares output for specified terminal. Known names are 37 for the (default) Teletype Corpora- 


tion Model 37 terminal, 1300 for the GE TermiNet 300 (or any terminal without half-line capa- 
bility), 300S for the DASI-300S, 300 for the DASI-300, and 450 for the DASI-450 (Diablo 


Hyterm). 
FILES 
/tmp/ta* temporary file 
/usr/lib/tmac/tmac.* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 
SEE ALSO 


J. F. Ossanna, Nroff!Troff user’ s manual 
B. W. Kernighan, A TROFF Tutorial 
troff(1), eqn(1), tbl(1), ms(7), me(7), man(7), col(1) 
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NAME 
od — file dump (octal, decimal, hex, ascii) 
SYNOPSIS 
od [ format ] [ file } [ [+] offset [.][b] [ label ]] 
DESCRIPTION 
Od displays the specified file or its standard input, in one or more dump formats as selected by the first 
argument. If the first argument is missing, —o is the default. Dumping continues until end-of-file. 
OPTIONS 
_ The meanings of the format argument characters are: 
—aoption 
| Interprets bytes as characters and display them with their ACSII names. If you specify the p option © 
as well, od underlines bytes with even parity. If you specify the P tai od underlines bytes with 
odd parity. With neither option, od ignores the parity bit. 
-—b Interprets bytes as unsigned octal. 
—c Interprets bytes as ASCII characters. Certain non-graphic characters appear as C escapes: 
null=\0, 
backspace=\b | 
formfeed=\f 
newline=\n 
return=\r 
tab=\t 
Others appear as 3-digit octal numbers. Od displays bytes with the parity bit set in octal. 
-—d Interprets (short) words as unsigned decimal. 
-f Interprets long words as floating point. | 
—h Interprets (short) words as unsigned hexadecimal. 
—i _ Interprets (short) words as signed decimal. 
-l Interprets long words as signed decimal. 
-—0 Interprets (short) words as unsigned octal. 


~—s[n] Looks for strings of ascii graphic characters, terminated with a null byte. N specifies the minimum 
length string to be recognized. By default, the minimum length is 3 characters. 


~v Shows all data. By default, display lines that are identical to the last line shown are not output, but | 
are indicated with an ‘‘*’’ in column 1. 


—w([n] . 
Specifies the number of input bytes to be interpreted and displayed on each output line. If you do not 
specify w, od reads 16 bytes for each display line. If n is not specified, it defaults to 32. 
x Interprets (short) words as hexadecimal. 
An upper case format character implies the long or double precision form of the object. 
The offset argument specifies the byte offset into the file where dumping is to commence. By default od 
interprets this argument in octal. You can specify a different radix. Appending ‘‘.’’ to the argument tells 
re hed interpret the offset in decimal. To have the offset interpreted in hexadecimal, begin the offset with 


or ‘‘Ox’’. If you append ‘‘b’’ (‘‘B’’) to the offset, od interprets the offset as a block count, where a 
block i is 512 (1024) bytes. If you omit the file argument, you must precde the offset argument with a ‘‘+’’. 


The radix of the displayed address will be the same as the radix of the offset, if specified. Otherwise, it will 
be octal. 
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Od interprets label as a pseudo-address for the first byte displayed. Od displays it in ‘‘()’’ following the 
file offset. It is intended for use with core images to indicate the real memory address. The syntax for 
label is identical to that for offset. 

SEE ALSO 
adb(1) 

BUGS 
A filename argument cannot begin with ‘‘+’’. A hexadecimal offset cannot be a block count. Only one 
filename argument can be given. 
It is an historical error to require specification of object, radix, and sign representation in a single character 
argument. 
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NAME | 
pagesize — print system page size 
SYNOPSIS ; . 
pagesize 
DESCRIPTION _ | 
Pagesize prints the size of a page of memory in bytes, as returned by getpagesize(2). This program is use- 
ful in constructing portable shell scripts. 
SEE ALSO 
getpagesize(2) 
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NAME 


chfn, chsh, passwd — change password file information 


SYNOPSIS 


passwd [ options } [ name ] 


DESCRIPTION 


This command changes (or installs) a password, login shell (—s option), or GECOS information field (-f 
option) associated with the user name (your own name by default). 


When altering a password, the program prompts for the current password and then for the new one. The 
caller must supply both. The new password must be typed twice to forestall mistakes. 


New passwords must be at least four characters long if they use a sufficiently rich alphabet and at least six 
characters long if monocase. These rules are relaxed if you are insistent enough. 


Only the owner of the name or the super-user may change a password; the owner must prove he knows the 
old password. , 


When altering a login shell, passwd displays the current login shell and then prompts for the new one. The 
new login shell must be one of the approved shells listed in /etc/shells unless you are the super-user. If 
/etc/shells does not exist, the only shells that may be specified are /bin/sh and /bin/csh. 


The super-user may change anyone’s login shell; normal users may only change their own login shell. 


When altering the GECOS information field, passwd displays the current information, broken into fields, 
as interpreted by the finger(1) program, among others, and prompts for new values. These fields include a 
user’s ‘‘real life’’ name, office room number, office phone number, and home phone number. Included in 
each prompt is a default value, which is enclosed between brackets. The default value is accepted simply 


by typing a carriage retum. To enter a blank field, the word ‘‘none’’ may be typed. Below is a sample run: 
Name [Biff Studsworth II): 
Room number (Exs: 597E or 197C) []: 521E 
Office Phone (Ex: 1632) []: 1863 
Home Phone (Ex: 987532) [5771546]: none 


Passwd allows phone numbers to be entered with or without hyphens. It is a good idea to run finger after 
changing the GECOS information to make sure everything is setup properly. 


The super-user may change anyone’s GECOS information; normal users may only change their own. 


FILES 
/etc/passwd The file containing all of this information 
/etc/shells The list of approved shells 

SEE ALSO 


login(1), finger(1), passwd(5), crypt(3). 
Robert Morris and Ken Thompson, UNIX password security 
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NAME 
pc — Pascal compiler 
SYNOPSIS 
pe [ options ] files 
DESCRIPTION . 

Pc is an optimizing ISO and/or ANSI/IEEE Pascal compiler. Pe accepts several types of arguments: 

Arguments whose names end with ‘ .p’ are Pascal source programs; they are compiled and left in a ‘.o’ file 

in the working directory. 

Arguments whose names end with ‘.f are Fortran 77 source programs; they are compiled and left in a ‘.o’ 

file in the working directory. 

The f77(1) and cc(1) commands are normally used for Fortran and C programs. When multi-lingual pro- 

grams need to be compiled, you can use any one of the three commands (cc, pc, or f77). 

Arguments whose names end with ‘.s’ are assembly language source programs; they are assembled and left 

na ‘.o’ file in the working directory. 

If you compile and link a single source file, pc deletes the ‘.o’ file. 

Pc creates ‘.s’ files for each module only if the user compiles with the —S option. 

OPTIONS 

Pe accepts the following options. Additional options are supported by Id(1). 

20 Generates code which assumes that a 68020 is present. To maintain compatibility with old 
code, the alignment rules are not changed unless you specify -X134. This alignment forces 
longwords to 32 bit boundaries,. 

—c Compiles to the ‘.o’ level only; does not link. . 

—C Compiles code to perform runtime checks, verifies assert calls, and initializes all variables to 
zero as in pi. : 

-f Generates code which assumes the presence of a 68881 coprocessor. By default many of the 
functions supported by the 68881 will be inline as well. Use -Z129 if you want a transcenden- 
tal call to go to the routine instead. 

—-g Generates BSD style debugger information in the assembly file, for use with a debugger such 
as dbx(2). 

—ga Generates a stack frame for every routine, regardless of need. 

—Idir ‘#include’ files whose names do not begin with ‘/’ are always sought first in the directory of 
the file argument, then in directories named in —I options, then in /usr/include. 

—0 output Names the final output file output. With this option, pc leaves the file ‘a.out’ undisturbed. 
This does not apply to assembly output. | 

~O Performs various speed optimizations, such as moving constant expressions out of loops. Gen- 
erally this makes your programs somewhat larger; if their performance is not loop bound, they 
may be slower as well. 

—02 Allows the optimizer to assume that memory locations do not change except by explicit stores. 
That is, the optimizer is guaranteed that no memory locations are I/O device registers that can 
be changed by external hardware and no memory locations are being shared with other 
processes which can change them asynchronously with respect to the current process. This 
compile time option must be used with extreme caution (or not at all) in device drivers, operat- 
ing systems, shared memory environments, and when interrupts (or UNIX signals) are present. 

—p Generates profiling code, in a manner similar to cc(1), and link the code with routines which 
Support ihe 
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—pg Generates profiling code similar to —p, but links with a more involved profiling mechanism 
which supports gprof(1). 
-R Makes initialized variables part of the text segment; passed on to as. 
-S Compile the named C programs and leaves the assembler-language output on corresponding 
files suffixed ‘.s’. 
-W Suppresses warming messages. 
—Xan Where n is an integer constant. Turns on option number n. There are numerous options avail- 
able for such things as signed bit fields, short return types, etc. You can find descriptions of 
these options in Section 8 of the UNIX Compiler Guide: C, Pascal, FORTRAN 77. 
—-Zn Turns off option number x. This is the reverse of the X option. This option is useful for turn- 
ing off options this are on by default. 
FILES 
file.p Pascal source file 
/bin/as assembler 
/usr/lib/pcom Pascal compiler 
fusr/lib/libc.a UNIX standard I/O library 
/usr/lib/libc_p.a profiling UNIX standard I/O library 
/usr/lib/libmce.a UNIX standard I/O library for the 68020/6888 1 
/usr/lib/libmc_p.a 68020/68881 Profiling UNIX Standard I/O library 
/usr/lib/libpc.a Pascal I/O library with math intrinsics 
/usr/lib/libpe_p.a profiling Pascal I/O library with math intrinsics 
/usr/lib/libm.a intrinsic floating point math library 
/usr/lib/libm_p.a profiling intrinsic floating point library 
/usr/lib/libmm.a 68020/68881 intrinsic floating point math library 
/usr/lib/libmm_p.a 68020/6888 1 intrinsic float point math library 
/usr/lib/libSkyc.a UNIX standard I/O library compiled for Sky FFP 
/usr/lib/libSkyc_p.a profiling UNIX Standard I/O library for Sky FFP 
/usr/lib/libSkym.a intrinsic math library for Sky FFP 
/usr/lib/libSkym_p.a profiling intrinsic math library for Sky FFP 
/usr/lib/Skycrt0.o* startup code for the Sky FFP 
/usr/lib/Skygcrt0.0* Sky profiling startup routine for gprof(1) profiling 
/usr/lib/Skymert0.0* Sky profiling for prof(1) startup 
/usr/lib/gcrt0.o* profiling startup code 
/lib/mcrt0.o* profiling startup code 
mon.out file produced for analysis by prof(1) 
gmon.out file produced for analysis by gprof(1) 
SEE ALSO 


8 June 


Kathleen Jensen and Niklaus Wirth, Pascal User Manual and Report, Springer-Verlag, 1978 


_ American National Standard Pascal Computer Programming Language, IEEE/John Wiley-Interscience, 


1983 


UNIX Compiler Guide: C, Pascal, FORTRAN 77 

as(1), prof(1), gprof(1), adb(1), dbx(1), Id(1), ce(1), £77(1), ce(1) 
DIAGNOSTICS 
The diagnostics produced by the Pascal compiler are intended to be self-explanatory and similar to those 
produced by the BSD pc compiler. Occasional messages may be produced by the assembler or loader. 
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NAME 
plot — graphics filters 


SYNOPSIS 
plot [ —Tterminal [ raster ] ] 


DESCRIPTION . 
These commands read plotting instructions (see plot(5)) from the standard input, and in general produce 
plotting instructions suitable for a particular terminal on the standard output. 


OPTION 
~Tterminal 
Specifies a terminal type. If no terminal type is specified, the environment parameter $TERM 
(see environ(7)) is used. Known terminals include the following: 
4014 Tektronix 4014 storage scope. 
450 DASI Hyterm 450 terminal (Diablo mechanism). 
300 DASI 300 or GSI terminal (Diablo mechanism). 
300S §DASI 300S terminal (Diablo mechanism). 
iswindow 
Integrated Solutions Optimum V WorkStation window. 
ver Versatec D1200A printer-plotter. This version of plot places a scan-converted image in 
/usr/tmp/raster and sends the result directly to the plotter device rather than to the stan- 
dard output. The optional argument sends a previously scan-converted file raster to the 
plotter. 
FILES 
~  fusr/bin/tek 
/usr/bin/t450 
/usr/bin/t300 
/usr/bin/t300s 
/usr/bin/twsplot 
/ust/bin/vplot 
___ /usr/tmp/raster 
SEE ALSO 


plot(3X), plot(S) 
BUGS 
There is no lockout protection for /usr/tmp/raster. 


1 August 1985 | _INTEGRATED SOLUTIONS 4.3 BSD 1 


PMERGE (1) UNIX Programmer’s Manual PMERGE (1) 


NAME 
pmerge — pascal file merger 
SYNOPSIS 
pmerge filename.p ... 
DESCRIPTION 
Pmerge assembles the named Pascal files into a single standard Pascal program and lists the resulting pro- 
gram on the standard output. You can use pmerge to merge a collection of separately compiled modules 
so that you can run them through pi(1) or export them to other sites. 
FILES 
/usr/tmp/MG* default temporary files 
SEE ALSO 
pc(1), pi(1), 
Auxiliary documentation Berkeley Pascal User's Manual. 
BUGS 


Pmerge does very little error checking, so incorrect programs will produce unpredictable results. Place 
block comments after the keyword they refer to or they are likely to end up in bizarre places. 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


PR(1) : _ UNIX Programmer’s Manual | | PR(1) 


NAME 
pr — print file 
SYNOPSIS 
pr [ options ] [ files ] 
DESCRIPTION 
Pr produces a printed listing of one or more files. The output is separated into pages headed by a date, the 
name of the file or a specified header, and the page number. If there are no file arguments, pr prints its 
standard input. . 
Inter-terminal messages via write(1) are forbidden while pr is running. 
OPTIONS . 
Options apply to all files specified; however, you can reset options between files. 
—n Produces n-column output. 
+n Begins printing with page n. 
—f Uses formfeeds instead of newlines to separate pages. Pr assumes a formfeed to use up two blank 
lines at the top of a page. (Consequently, this option does not affect the effective page length.) 
—h header 
Takes header as a page header. 
-ln Takes the length of the page to be 7 lines instead of the default 66. 
—m Prints all files simultaneously, each in one column. 
—SC Separates columns by the single character c instead of by the appropriate amount of white space. 
__ Pr interprets a missing c to be a tab. | 
-t Tells pr not to print the 5-line header or the 5-line trailer normally supplied for each page. 
—wn _ For purposes of multi-column output, takes the width of the page to be » characters instead of the 
default 72. . 
FILES 
/dev/tty? to suspend messages 
SEE ALSO 
cat(1) 
DIAGNOSTICS 


There are no diagnostics when pr is printing on a terminal. 
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NAME 
printenv — print out the environment 


SYNOPSIS 
printenv [ name ] 


DESCRIPTION 
Printenv prints out the values of the variables in the environment. If you specify a variable name, 
printenv prints only the value of that variable. 
If you specify a name that is not defined in the environment, printenv returns exit status 1. Otherwise, it 
returns status 0. 

SEE ALSO 
sh(1), environ(7), csh(1) 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


PROF (1) 


NAME 


UNIX Programmer’s Manual PROF (1) | 


prof — display profile data 


SYNOPSIS 


prof [ options ] [—v [—low [ —high] ] ] [ a.out [ mon.out ...]} 


- DESCRIPTION 


Prof interprets the file produced by the monitor subroutine. Under default modes, prof reads the symbol 
table in the named object file (a.out by default) and correlates it with the profile file (mon.out by default). 
For each external symbol, the percentage of time spent executing between that symbol and the next is 
printed (in decreasing order), together with the number of times that routine was called and the number of 
milliseconds per call. If you specify more than one profile file, the output represents the sum of the 


profiles. 


To tally the number of calls to a routine, specify the —p option of cc, f77, or pe when you compile the file 
containing the routine. This option also arranges for the profile file to be produced automatically. . 


OPTIONS 

-a Reports all symbols, not just external symbols. 

-l Sorts the output by symbol value. 

—n Sorts the output by number of calls. 

—Ss Produces a summary profile file in mon.sum. This is useful only when you specify more than one 
profile file. 

-v Suppresses all printing and produces a graphic version of the profile on the standard output for 
display by the plot(1) filters. When plotting, the numbers low and high, by default 0 and 100, may 
be given to cause a selected percentage of the profile to be plotted with accordingly higher resolu- 
tion. 

—Z Prints in the ouput routines which have zero usage (as indicated by call counts and accumulated 
time).. . 

FILES | 
. mon.out for profile 
- aout for namelist 
mon.sum for summary profile 
SEE ALSO 


monitor(3), profil(2), ec(1), plot(1G) 


BUGS 


Beware of quantization errors. 
Prof is confused by f77, which puts the entry points at the bottom of subroutines and functions. 
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NAME 
Ps — process status 


SYNOPSIS 
ps [ options ] 


DESCRIPTION _ | 
Ps prints information about processes. Normally, ps prints only your own processes. With the —a option, 
Pps prints other users’ processes. With the —x option, it includes information about processes without con- 
trol terminals. 


All output formats include the following for each process: 
PID the process id 
TT control terminal of the process 
TIME Cpu time used by the process (includes both user and system time) 
STAT the state of the process 
COMMAND an indication of the command which is running. 


Ps identifies the state of a process by a sequence of four letters, e.g. ‘““RWNA’’. The first letter indicates 
the runnability of the process: 

runnable processes 

stopped processes 

processes in page wait 

those in disk (or other short term) waits 

those sleeping for less than about 20 seconds 

idle (sleeping longer than about 20 seconds) 

The second letter indicates whether a process is swapped out, showing W if it is, or a blank if it is loaded 


(in-core); a process which has specified a soft limit on memory requirements and which is exceeding that 
limit shows >; such a process is (necessarily) not swapped. 


The third letter indicates whether a process is running with altered CPU scheduling priority (nice); if the 
process priority is reduced, an N is shown, if the process priority has been artificially raised then a ‘<’ is 
shown; processes running without special treatment have just a blank. 


MAO Vs zw 


The final letter indicates any special treatment of the process for virtual memory replacement; the letters 
correspond to options to the vadvise(2) call. Currently the possibilities are as follows: 
A VA_ANOM ‘ 
S VA_SEQL 
blank VA_NORM 
An A typically represents a lisp(1) in garbage collection, S is typical of large image processing programs 
which are using virtual memory to sequentially address voluminous data. 
OPTIONS 
~a Requests information about all processes with terminals (ordinarily ps displays only the user’s own 
processes). 
-—c Prints the command name as stored internally in the system for purposes of accounting rather than 
the command arguments, which are kept in the process’ address space. This is more reliable, if less 
informative, since the process is free to destroy the latter information. 


Prints the environment as well as the arguments to the command. 


—-e 

-g Tells ps to list information about all processes. Without this option, ps prints information about 
‘interesting’ processes only. Ps coniders process group leaders to be uninteresting processes. Thus, 
ps normally excludes top-level command interpreters and processes waiting for users to login on free 

-k Tells ps to use the file /vmcore in place of /dev/‘kmem and /dev/mem. Use this option for 
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postmortem system debugging. 
Requests a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN as described 
below. 


Asks for numerical output. In a long listing, the WCHAN field is printed numerically rather than 
symbolically, or, in a user listing, the USER field is replaced by a UID field. 


Adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to the basic 
output format. 


Restricts output to processes whose controlling tty is x (which should be specified as printed by ps, 
e.g. t3 for tty3, tco for console, td0 for ttyd0, t? for processes with no tty, t for processes at the 
current tty, etc). This option must be the last one given. 


Produces user-oriented output. This includes fields USER, %CPU, NICE, SIZE, and RSS as 
described below. 


Prints a version of the output containing virtual memory statistics. This includes fields RE, SL, 
PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, %CPU and %MEM, described below. 


Uses a wide output format (132 columns rather than 80); if repeated, e.g. ww, uses arbitrarily wide 
output. Ps uses this information to decide how much of long commands to print. 


Requests information about processes with no terminal. 


Causes ps to update a private database in which system information is kept. Thus ‘‘ps U’’ should be 
included in the /etc/rc file. 


A process number may be given, (indicated here by #), in which case the output is restricted to that 
process. This option must also be last. 


Ps considers a second argument to be the file containing the system’s namelist. Otherwise, ps uses 
/vmunix. A third argument tells ps where to look for core if the k option is given, instead of /vmcore. If 

- you specify a fourth argument, ps interprets it as the name of a swap file to use instead of the default 
/dev/drum. 


Fields which are not common to all output formats: 


USER name of the owner of the process | 
%CPU cpu utilization of the process; this is a decaying average over up to a minute of previous (real) 


time. Since the time base over which this is computed varies (since processes may be very 
young), it is possible for the sum of all %CPU fields to exceed 100%. 

(or NI) process scheduling increment (see setpriority(2)) 

virtual size of the process (in 1024 byte units) 

real memory (resident set) size of the process (in 1024 byte units) 

soft limit on memory used, specified via a call to setrlimit(2); if no limit has been specified 
then shown as xx 

size of text (shared program) image 

size of resident (real memory) set of text 


%MEM __spercentage of real memory used by this process. 


residency time of the process (seconds in core) 
sleep time of the process (seconds blocked) 


PAGEIN number of disk i/o’s resulting from references by the process to pages not loaded in core. 


numerical user-id of process owner 

numerical id of parent of process 

short-term cpu utilization factor (used in scheduling) 

process priority (non-positive when in non-interruptible wait) 


ADDR swap address of the process 
WCHAN event on which process is waiting (an address in the system). A symbol is chosen that 
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classifies the address, unless numerical output is requested (see the n flag). In this case, ps 
trims off the initial part of the address and prints it hexadecimally, e.g., 0x80004000 prints as 
4000. 

F flags associated with process as in <sys/proc.h>: 

SLOAD 000001 in core 

SSYS 000002 swapper or pager process 

SLOCK 000004 process being swapped out 

SSWAP 000008 save area flag 

STRC 000010 process is being traced 

SWTED 000020 another tracing flag 

SULOCK 000040 user settable lock in core 

SPAGE 000080 process in page wait state 

SKEEP 000100 another flag to prevent swap out 

SDLYU 000200 delayed unlock of pages 

SWEXIT 000400 working on exiting 

SPHYSIO 000800 doing physical i/o (bio.c) 

SVFORK 001000 process resulted from vfork() 

SVFDONE 002000 another vfork flag 

SNOVM 004000 no vm, parent in a vfork() 

SPAGI 008000 init data space on demand from inode 

SANOM 010000 system detected anomalous vm behavior 

SUANOM — 020000 user warned of anomalous vm behavior 

STIMO 040000 timing out during sleep 

SDETACH 080000 detached inherited by init 

SOUSIG 100000 using old signal mechanism 
A process that has exited and has a parent that has not yet waited for the process is marked <defunct>. A 
process which is blocked trying to exit is marked <exiting>. Ps makes an educated guess about the 
filename and arguments given when the process was created by examining memory or the swap area. The 
method is inherently unreliable. Furthermore, a process can to destroy this information, so the names can- 
not be counted on too much. 

FILES 

/vmunix system namelist 
/dev/kmem kere] memory 
/dev/drum swap device 
/ymcore core file 
Idev searched to find swap device and tty names 
. letc/psdatabase system namelist, device, and wait channel information 
SEE ALSO 
kill(1), w(1) 
BUGS 


That status of process can change while ps is running. Ps, then, provides only an approximation of the pro- 


CeéSs Status. 
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NAME 

ptx — permuted index 
SYNOPSIS 

ptx [ options ] [ input [ output] ] 
DESCRIPTION 

Ptx generates a permuted sex to file input on file output (by default, standard input and output). It has 

three phases: the first does the permutation, generating one line for each keyword in an input line. Ptx 
rotates the keyword to the front. Then ptx sorts the permuted file. Finally, ptx rotates the sorted lines so 
the keyword comes at the middle of the page. 


Ptx produces output in the form: 

xx "tail" "before keyword" "keyword and after” “head” 
where .xx may be an nroff or troff(1) macro for user-defined formatting. The before keyword and key- 
word and after fields incorporate as much of the line as will fit around the keyword when it is printed at the 
middle of the page. Tail and head, at least one of which is an empty string "", are wrapped-around pieces 


small enough to fit in the unused space at the opponte end of the line. When original text must be dis- 
carded, ‘/’ marks the spot. 


The index for this manual was generated using ptx. 


OPTIONS 
~—b break 
Uses the characters in the break file to separate words. In any case, tab, newline, and space sak 
acters are always used as break characters. 
-f Folds upper and lower case letters for sorting. 


-gn Uses the next argument, n, as the number of characters to allow for each gap among the four parts 
of the line as finally printed. The default gap is 3 characters. 


~—i ignore 
Does not use as keywords any words given in the ignore file. If the —i and —o options are missing, 
use /usr/lib/eign as the ignore file. 


~—o only Uses as keywords only the words given in the only file. 


—r Takes any leading nonblank characters of each input line to be a reference identifier (as to a page 
or chapter) separate from the text of the line. Attaches that identifier as a Sth field on each output 
line. 

-t Prepares the output for the phototypesetter; the default line length is 100 characters. 

—wn _ Uses the next argument, 2, as the width of the output line. The default line length is 72 characters. 

FILES 
/usr/bin/sort 
. /usr/lib/eign 
BUGS . 
Line length counts do make allowance for overstriking or proportional spacing. 
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NAME 
pwd — working directory name 
SYNOPSIS 
pwd 
DESCRIPTION 
Pwd prints the pathname of the working (current) directory. 
SEE ALSO 
cd(1), esh(1), getwd(3) 
BUGS 


In csh(1) the command dirs is always faster (although it can give a different answer in the rare case that 
the current directory or a containing directory was moved after the shell descended into it). 


~~ 
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NAME 
pxref — Pascal cross-reference program 
SYNOPSIS | | 
pxref [ option } flename 
DESCRIPTION : 
Pxref makes a line numbered listing and a cross-reference of identifier usage for the program in filename. 
It treats the keywords goto and label as identifiers for the purpose of the cross-reference. Pxref does not 
process include directives, but it does place an entry indexed by ‘#include’ in the cross-reference. 
OPTIONS 
: _ Suppresses the listing. 
SEE ALSO 
Berkeley Pascal User’s Manual 
BUGS 
Pxref trims identifiers to 10 characters. 
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NAME 

quota — display disk usage and limits 
SYNOPSIS 

quota [ options } [ user ] 


DESCRIPTION 
Quota displays a user’s disk usage and limits. Only the super-user may use the optional user argument to 
view the limits of users other than himself. 
Without options, quota displays only warnings about mounted file systems where usage is over quota. 
OPTIONS 
-VvV Displays user’s quotas on all mounted file systems where quotas exist. 
FILES 
quotas quota file at the file system root 


SEE ALSO 
quotactl(2), quotaon(8), edquota(8) 
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NAME 
ranlib — convert archives to random libraries 


SYNOPSIS 
ranlib [ option ] archive ... 


DESCRIPTION 
Ranlib converts each archive to a form which the loader can load more rapidly. Ranlib does this by 
adding a table of contents called _.SYMDEF to the beginning of the archive. Ranlib uses ar(1) to recon- 
struct the archive, so that sufficient temporary file space must be available in the file system which contains 
the current directory. 


OPTIONS 
-t Tells ranlib only to "touch" the archives and not to modify them. This option is useful after copy- 
ing an archive or using the -t option of make(1) to prevent kd(1) from complaining about an “‘out 
of date’’ symbol table. . 
SEE ALSO 
id(1), ar( 1), lorder(1), make(1) 


BUGS 
Because generation of a library by ar and randomization of the library by ranlib are separate processes, 
phase errors are possible. The loader, Id, warns when the modification date of a library is more recent than 
the creation date of its dictionary; but this means that you get the warning even if you only copy the library. 
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NAME 
ratfor — rational Fortran dialect 


SYNOPSIS 
ratfor [ option ...] [ filename ... ] 
DESCRIPTION 
Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides control flow 
constructs essentially identical to those in C: 
Statement grouping: 
{ statement; statement; statement } 
decision-making: 
if (condition) statement [ else statement ] 
switch (integer value) { 
case integer: statement 


[ default: } statement 
} 
loops: while (condition) statement 
for (expression; condition; expression) statement 
do limits statement 
repeat statement [ until (condition) } 
break 
next 


and some syntactic sugar to make programs easier to read and write: 


free form input: 
multiple statements/line; automatic continuation 


comments: 
# this is a Comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 
include: include filename 
Ratfor is best used with f77(1). 


SEE ALSO 
{77(1) 
B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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- NAME 


rcp — remote file copy 


SYNOPSIS 


rcp [—p ] filel file2 | 
rep (—p ] [-r ] file ... directory 


DESCRIPTION 


Rep copies files between machines. Each file or directory argument is either a remote filename of the form 
“‘rhost:path’’ or a local filename (containing no ‘:’ characters, or a ‘/’ before any ‘:’s). 


By default, rcp preserves the mode and owner of file2 if file2 already existed. Otherwise rcp uses the 
mode of the source file modified by the umask(2) on the destination host. 


If path is not a full path name, rep interprets it relative to your login directory on rhost. You can quote 
path on a remote host (using \, ", or “) so that the metacharacters are interpreted remotely. 


Rep does not prompt for passwords. Your current local user name must exist on rhost and allow remote 
command execution via rsh(1C). 


Rep handles third party copies, where neither source nor target files are on the current machine. Host- 
names may also take the form ‘‘rname@rhost’’ to use rname rather than the current user name on the 
remote host. The destination hostname may also take the form ‘‘rhost.mame’’ to support destination 
machines that are running 4.2BSD versions of rcp. 


OPTIONS | : | 
—p Causes rcp to attempt to preserve (duplicate) in its copies the modification times and modes of the 
source files, ignoring the umask. 
-r If any of the specified source files are directories, copies each subtree rooted at that name. If you 
uses —r, the destination of the copy must be a directory. 
SEE ALSO 


- BUGS 


cp(1), ftp(1C), rsh(1C), rlogin(1C) 


Rep does not detect all cases where the target of a copy might be a file in cases where only a directory 
should be legal. 

Rep is confused by any output generated by commands in a Jogin, profile, or .cshrc file on the remote 
host. 
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NAME 


rdist — remote file distribution program 


SYNOPSIS 


rdist [—nqbRhivwy } [ —f distfile ] [—-d var=value } [—m host] [ name ... ] 
rdist [—nqbRhivwy ] —c name ... [ login@ ] host [ :dest } 


DESCRIPTION : 


Rdist is a program to maintain identical copies of files over multiple hosts. It preserves the owner, group, 
mode, and mtime of files if possible and can update programs that are executing. Rdist reads commands 
from distfile to direct the updating of files and/or directories. If distfile is ‘—’, the standard input is used. If 
no —f option is present, the program looks first for ‘distfile’, then ‘Distfile’ to use as the input. If no names 
are specified on the command line, rdist will update all of the files and directories listed in distfile. Other- 
wise, the argument is taken to be the name of a file to be updated or the label of a command to execute. If 
label and filenames conflict, it is assumed to be a label. These may be used together to update specific files 
using specific commands. 


The —c option forces rdist to interpret the remaining arguments as a small distfile. The equivalent distfile 
is as follows. 


( name ...) -> [login@]host 
install [dest] ; 


Other options: 


-d Define var to have value. The —d option is used to define or override variable definitions in the 
distfile. Value can be the empty string, one name, or a list of names surrounded by parentheses 
and separated by tabs and/or spaces. 


—m Limit which machines are to be updated. Multiple -m arguments can be given to limit updates to a 
subset of the hosts listed the distfile. 


—n Print the commands without executing them. This option is useful for debugging distfile. 
-q Quiet mode. Files that are being modified are normally printed on standard output. The —q option 
suppresses this. 


-R Remove extraneous files. If a directory is being updated, any files that exist on the remote host that 
do not exist in the master directory are removed. This is useful for maintaining truely identical 
copies of directories. 


—-h Follow symbolic links. Copy the file that the link points to rather than the link itself. 


-i Ignore unresolved links. Rdist will normally try to maintain the link structure of files being 
transfered and warn the user if all the links cannot be found. 


—-Vv Verify that the files are up to date on all the hosts. Any files that are out of date will be displayed 
but no files will be changed nor any mail sent. 


-w Whole mode. The whole filename is appended to the destination directory name. Normally, only 
the last component of a name is used when renaming files. This will preserve the directory struc- 
ture of the files being copied instead of flattening the directory structure. For example, renaming 2 
list of files such as ( dirl/f1 dir2/f2 ) to dir3 would create files dir3/dir1/f1 and dir3/dir2/f2 instead 
of dir3/f1 and dir3/f2. 


-y Younger mode. Files are normally updated if their mtime and size (see stat(2)) disagree. The —y 
option causes rdist not to update files that are younger than the master copy. This can be used to 
prevent newer copies on other hosts from being replaced. A warning message is printed for files 
which are newer than the master copy. 
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—b Binary comparison. Perform a binary comparison and update files if they differ rather than com- 
paring dates and sizes. 


Distfile contains a sequence of entries that specify the files to be soled the destination hosts, and what 
Operations to perform to do the updating. Each entry has one of the following formats. 


<variable name> ‘=’ <name list> ; 
[ label: ] <source list> ‘->’ <destination list> <command list> 
[ label: ] <source list> ‘::’ <time_stamp file> <command list> 


The first format is used for defining variables. The second format is used for distributing files to other 
hosts. The third format is used for making lists of files that have been changed since some given date. The 
source list specifies a list of files and/or directories on the local host which are to be used as the master 
copy for distribution. The destination list is the list of hosts to which these files are to be copied. Each file 
in the source list is added to a list of changes if the file is out of date on the host which is being updated 
(second format) or the file is newer than the time stamp file (third format). 


Labels are optional. They are used to identify a command for partial updates. 


Newlines, tabs, and blanks are only used as separators and are otherwise ignored. Comments begin with ‘#’ 
and end with a newline. 


Variables to be expanded begin with ‘$’ followed by one character or a name enclosed in curly braces (see 
the examples at the end). 


The source and destination lists have the following format: 


<name> 
or | 
‘(’ <zero or more names separated by white-space> ‘)’ 


The shell meta-characters ‘[’, ‘]’, ‘{’, ‘}’, ‘*’, and ‘?’ are recognized and expanded (on the local host only) 
in the same way as csh(1). They can be escaped with a backslash. The ‘~’ character is also expanded in 
the same way as csh but is expanded separately on the local and destination hosts. When the —w option is 
used with a filename that begins with ‘~’, everything except the home directory is appended to the destina- 
tion name. File names which do not begin with ‘/’ or ‘~’ use the destination user’s home directory as the 
root directory for the rest of the filename. 


The command list consists of zero or more commands of the following format. 


‘install’ <options> opt_dest_name ‘;’ 
‘notify’ <name list>‘;’ 

‘except’ <name list>‘;’? _ 

“except_pat’ <pattern list>‘;’ 
‘special’ <name list>string ‘;’ 


The install command is used to copy out of date files and/or directories. Each source file is copied to each 
host in the destination list. Directories are recursively copied in the same way. Opt_dest_name is an 
optional parameter to rename files. If no install command appears in the command list or the destination 
name is not specified, the source filename is used. Directories in the path name will be created if they do 
not exist on the remote host. To help prevent disasters, a non-empty directory on a target host will never be 
replaced with a regular file or a symbolic link. However, under the ‘—R’ option a non-empty directory will 
be removed if the corresponding filename is completely absent on the master host. The options are ‘—R’, 
‘—h’, ‘-i’, ‘—v’, ‘-w’, ‘~y’, and ‘—b’ and have the same semantics as options on the command line except 
they iy apply to the files in the source list. The login name used on the destination host is the same as the 
local host unless the destination name is of the format ““‘login@host". 
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The notify command is used to mail the list of files updated (and any errors that may have occured) to the 
listed names. If no ‘@’ appears in the name, the destination host is appended to the name (e.g., 
namel @host, name2@host, ...). 


The except command is used to update all of the files in the source list except for the files listed in name 
list. This is usually used to copy everything in a directory except certain files. 


The except_pat command is like the except command except that pattern list is a list of regular expressions 
(see ed(1) for details). If one of the patterns matches some string within a filename, that file will be 
ignored. Note that since ‘\’ is a quote character, it must be doubled to become part of the regular expres- 
sion. Variables are expanded in pattern list but not shell file pattem matching characters. To include a ‘$’, 
it must be escaped with ‘\’. 

The special command is used to specify sh(1) commands that are to be executed on the remote host after 
the file in name list is updated or installed. If the name list is omitted then the shell commands will be exe- 
cuted for every file updated or installed. The shell variable ‘FILE’ is set to the current filename before exe- 
cuting the commands in string. String starts and ends with ‘"’ and can cross multiple lines in distfile. Mul- 
tiple commands to the shell should be separated by ‘;’. Commands are executed in the user’s home direc- 
tory on the host being updated. The special command can be used to rebuild private databases, etc. after a 
program has been updated. 


The following is a small example. 
HOSTS = ( matisse root@arpa) 


FILES = ( /bin /lib /usr/bin /usr/games 
/usr/include/{*.h,{stand,sys,vax*,pascal,machine}/*.h} 
/usr/lib /usr/man/man? /usr/ucb /usr/local/rdist ) 


EXLIB = ( Mail.re aliases aliases.dir aliases.pag crontab dshrc 
sendmail.cf sendmail.fc sendmail.hf sendmail.st uucp vfont ) 


${FILES} -> ${HOSTS} 
install -R ; 
except /usr/lib/${EXLIB} ; 
except /usr/games/lib ; 
special /usr/lib/sendmail "/usr/lib/sendmail -bz” ; 


SICS: 
/ust/src/bin -> arpa 
except_pat (\\.o\$ /SCCS\$ ) ; 


IMAGEN = (ips dviimp catdvi) 


imagen: 

/usr/local/$ {IMAGEN} -> arpa 
install /usr/local/lib ; 
notify ralph ; 


${FILES} :: stamp.cory 
notify root@cory ; 


FILES 
distfile input command file 
/tmp/rdist* temporary file for update lists 
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SEE ALSO 
sh(1), csh(1), stat(2) 


DIAGNOSTICS | | 
A complaint about mismatch of rdist version numbers may really stem from some problem with starting 
your shell, e.g., you are in too many groups. 


‘BUGS 
Source files must reside on the local host where rdist is executed. 


There is no easy way to have a special command executed after all files in a directory have been updated. 
Variable expansion only works for name lists; there should be a general macro facility. 
Rdist aborts on files which have a negative mtime (before Jan 1, 1970). 


There should be a ‘force’ option to allow replacement of non-empty directories by regular files or sym- 
links. A means of updating file modes and owners of otherwise identical files is also needed. 
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refer — find and insert literature references in documents 


SYNOPSIS 


refer [ options } [ file ... 


DESCRIPTION 


Refer is a preprocessor for nroff or troffit) that finds and formats references for footnotes or endnotes. It 
is also the base for a series of programs designed to index, search, sort, and print stand-alone bibliogra- 
phies, or other data entered in the appropriate form. 


Given an incomplete citation with sufficiently precise keywords, refer searches a bibliographic database 
for references containing these keywords anywhere in the title, author, journal, etc. Refer copies the input 
file (or standard input) to standard output, except for lines between .[ and .] delimiters, which it assumes to 
contain keywords Refer replaces these lines with information from the bibliographic database. The user 
may also search different databases, override particular fields, or add new fields. Refer assigns the refer- 
ence data, from whatever source, to a set of troff strings. Macro packages such as ms(7) print the finished 
reference text from these strings. By default references are flagged by footnote numbers. 


OPTIONS 
—an 
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Reverses the first n author names (Jones, J. A. instead of J. A. Jones). If n is omitted all author 
Names are reversed. 


Bare mode: does not put any flags in text (neither numbers nor labels). 


Bibliography mode: takes a file composed of records separated by blank lines, and turn them 
into troff input. Turns label / into the macro .m with | defaulting to %X and .m Getaulong to 
-AP (annotation paragraph). 


Capitalizes (with CAPS SMALL CapPs) the fields whose key-letters are in keys. 


Instead of leaving the references where encountered, accumulates them until a sequence of the 
form 

f 

$LISTS$ 

J 
is encountered, and then write out all references collected so far. Collapses references to same 
source. 


Sets the footnote number to nm instead of the default of 1 (one). With labels rather than 
numbers, this flag is a no-op. 

Instead of numbering references, uses labels as specified in a reference data line beginning 
%x; by default x is L. 


Instead of numbering references, uses labels made from the senior author’s last name and the 
year of publication. Only the first m letters of the last name and the last n digits of the date are 
used. If either m or n is omitted the entire name or date respectively is used. 


Does not search the default file /usr/dict/papers/Ind. If there is a REFER environment variable, 
the specified file will be searched instead of the default file; in this case the —n flag has no 
effect. 


Takes the next argument bib as a file of references to be searched. Searches the default file 
last. 


Places punctuation marks .,:;?! after the reference signal, rather than before. (Periods and 
commas used to be done with strings.) 


Sorts references by fields whose key-letters are in the keys string; permutes reference numbers 
in text accordingly. Implies —e. The key-letters in keys may be followed by a number to indi- 
cate how many such fields are used, with + taken as a very large number. The default is AD 
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which sorts on the senior author and then date. To sort, for example, on all authors and then 
title, use -sA+T. 


-§ Produces references in the Natural or Social Science format. 


To use your own references, put them in the format described below. They can be searched more rapidly 
by running indxbib(1) on them before using refer; failure to index results in a linear search. When refer 
is used with the eqn, neqn or tbl preprocessors refer should be first, to minimize the volume of data passed 
through pipes. 


The refer preprocessor and associated programs expect input from a file of references composed of records 
separated by blank lines. A record is a set of lines (fields), each containing one kind of information. Fields 
Start on a line beginning with a ‘‘%’’, followed by a key-letter, then a blank, and finally the contents of the 
field, and continue until the next line starting with ‘‘“%’’. The output ordering and formatting of fields is 
controlled by the macros specified for nroff/troff (for footnotes and endnotes) or roffbib (for stand-alone 
bibliographies). For a list of the most common key-letters and their corresponding fields, see addbib(1). 
An example of a refer entry is given below. 


EXAMPLE 


FILES 


%A M. E. Lesk 

%T Some Applications of Inverted Indexes on the UNIX System 
%B UNIX Programmer’ s Manual 

%V 2b 

GI Bell Laboratories 

%C Murray Hill, NJ 

%D 1978 


/usr/dict/papers directory of default publication lists 
/usr/lib/refer directory of companion programs 


SEE ALSO 


BUGS 


addbib(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1) 


Blank spaces at the end of lines in bibliography fields will cause the records to sort and reverse incorrectly. 
Sorting large numbers of references causes a core dump. 
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NAME 

rev — reverse lines of a file 
SYNOPSIS 

rev [file]... 
DESCRIPTION 


Rev copies the named files to the standard output, reversing the order of characters in every line. If no file 
is specified, the standard input is copied. 
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NAME _ 


rlogin — remote login 


SYNOPSIS 


rlogin rhost [ options ] 
rhost [ options } 


DESCRIPTION 


Rlogin connects your terminal on the current local host system /host to the remote host system rhost. 


Each host has a file /etc/hosts.equiv which contains a list of rhost’s with which it shares account names. 
(The host names must be the standard names as described in rsh(1C).) When you rlogin as the same user 
on an equivalent host, you don’t need to give a password. Each user may also have a private equivalence 
list in a file .rhosts in his login directory. Each line in this file should contain an rhost and a username 
separated by a space, giving additional cases where logins without passwords are to be permitted. If the 
originating user is not equivalent to the remote user, then a login and password will be prompted for on the 
remote machine as in login(1). To avoid some security problems, the -rhosts file must be owned by either 
the remote user or root. | 


The remote terminal type is the same as your local terminal type (as given in your environment TERM 
variable). The terminal or window size is also copied to the remote system if the server supports the 
option, and changes in size are reflected as well. All echoing takes place at the remote site, so that (except 
for delays) the rlogin is transparent. Flow control via “S and “Q and flushing of input and output on inter- 
rupts are handled properly. 


OPTIONS 


-8 Allows an eight-bit input data path at all times. Without this option, parity bits are stripped 
except when the remote side’s stop and start characters are other than “S and *Q. 


—ec Specifies c as the escape character. No space should separate this option flag and the argument 
character. 


—] username 
_ Logs in as the specified user. As part of the login procedure, rlogin or rhost prompts for the 
user’s password. 


-L Allows the rlogin session to be run in litout mode. A line of the form ‘‘~.’’ disconnects from 
the remote host, where ‘‘~’’ is the escape character. Similarly, the line ‘‘“Z’’ (where “Z, 
control-Z, is the suspend character) will suspend the rlogin session. Substitution of the 
delayed-suspend character (normally “Y) for the suspend character suspends the send portion 
of the rlogin, but allows output from the remote system. 


SEE ALSO 


FILES 


BUGS 


~ rsh(1C) 


/usr/hosts/* for rhost version of the command 


More of the environment should be propagated. 
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rm, rmdir — remove (unlink) files or directories 


SYNOPSIS 


rm [ options ] file ... 


rmdir dir ... 


DESCRIPTION 


Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write permission in its directory, but neither read nor write per- 
mission on the file itself. 


If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with ‘y’ the file is deleted, otherwise the file remains. 


Rmdir removes entries for the named directories, which must be empty. Rmdir does not understand any 
of the options accepted by rm. 


OPTIONS 


—f 


-i 


-Tr 


SEE ALSO 


Indicates that all the arguments following it are to be treated as filenames. This allows the 
specification of filenames starting with a minus. (— is called the null option.) 


Forces rm not to ask questions and not to report errors. 


Asks whether .to delete each file, and, under —-r, whether to examine each directory. (The "i" 
stands for interactive.) 


Recursively deletes the entire contents of the specified directory and the directory itself. Without 
this option, rm prints an error message when asked to delete a directory. 


rm(1), rmdir(1), unlink(2), rmdir(2) 
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NAME 
rmail — handle remote mail received via uucp 


SYNOPSIS 
rmail user ... 


DESCRIPTION 
Rmail interprets incoming mail received via uucp(1C), collapsing ‘‘From’’ lines in the form generated by 
binmail(1) into a single line of the form ‘‘return-path!sender’’ and passing the processed mail on to send- 
mail(8). 
Rmail is explicitly designed for use with uucp and sendmail. 

SEE ALSO 
binmail(1), uucp(1C), sendmail(8) 


BUGS 
Rmail should not reside in /bin. 
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NAME 
rmdir — remove (unlink) directories 
SYNOPSIS 
rmdir dir ... 
DESCRIPTION 
Rmdir removes entries for the named directories, which must be empty. 


SEE ALSO 
rm(1), unlink(2), rmdir(2) 
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NAME 
roffbib — run off bibliographic database 
SYNOPSIS 
roffbib [ options } [ file ...] 
DESCRIPTION . 
Roffbib prints out all records in a bibliographic database, in bibliography format rather than as footnotes or 
endnotes. Generally it is used in conjunction with sortbib: 
 sortbib database | roffbib 
Roffbib accepts most of the options understood by nroff(1), most importantly the —T flag to specify termi- 
nal type. 
If abstracts or comments are entered following the %X field key, roffbib will format them into paragraphs 
for an annotated bibliography. Several %X fields may be given if several annotation paragraphs are 
desired. 
OPTIONS 
-e Equally spaces words in justified lines. 
—h Speeds output with tabs (set every 8 spaces). 
—m macros Specifies a user-defined set of macros to replace the macros defined in /usr/lib/tmac/tmac.bib. 
Note that there should be a space between the —m and the macro filename. 
—nn Numbers the first page 7. 
—olist Prints only listed page numbers; n-m indicates a range. 
-roption Four command-line registers control formatting style of the bibliography, much like the 
number registers of ms(7). The command-line argument —rN1 will number the references 
Starting at one (1). The flag —-rV2 will double space the bibliography, while -rV1 will double. 
space references but single space annotation paragraphs. The line length can be changed from 
the default 6.5 inches to 6 inches with the —rL6i argument, and the page offset can be set from. 
the default of 0 to one inch by specifying —rOli (capital O, not zero). Note: with the —V and 
—Q flags the default page offset is already one inch. 
Nn Reference numbering begins at 7. 
Van Sets vertical spacing to v lines. 
Las Changes line length to n units in scale s (6.5i default). 
Ons Changes page offset to units in scale s (0 default). 
s Scale: i for inches, c for centimeters. 
—Sn Stops every n pages (1 by default). 
-—Q Queues output for the phototypesetter. 
-Tterm _ As in nroff, specifies the terminal type. 
-V Sends output to the Versatec. 
~-x Suppresses the printing of these abstracts. 
FILES 
/usr/lib/tmac/tmac.bib file of macros used by nroff/troff 
SEE ALSO 
refer(1), addbib(1), sortbib(1), indxbib(1), lookbib(1) 
BUGS | 7 


Users have to rewrite macros to create customized formats. 
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NAME 
rsh — remote shell 


SYNOPSIS 
rsh host [—l username ] [ option |] command 
host [ —/ username ] [ option ] command 

DESCRIPTION 
Rsh connects to the specified host, and executes the specified command. Rsh copies its standard input to 
the remote command, the standard output of the remote command to its standard output, and the standard 
error of the remote command to its standard error. Interrupt, quit, and terminate signals are propagated to 
the remote command. Rsh normally terminates when the remote 


The remote username used is the same as your local username, unless you specify a different remote name 
with the —I option. This remote name must be equivalent (in the sense of rlogin(1C)) to the originating 
account. Rsh makes no provisions for specifying a password with a command. 


If you omit command, rsh logs you in on the specified remote host using rlogin(1C). Once logged in, you 
can execute Commands on that machine. 


Rsh interprets unquoted shell metacharacters on the local machine and quoted metacharacters on the 
remote machine. Thus the command 


rsh otherhost cat remotefile >> localfile 

appends the remote file remotefile to the localfile localfile, while 
rsh otherhost cat remotefile ">>" otherremotefile 

appends remotefile to otherremotefile. 


Hostnames are given in the file /etc/hosts. Each host has one standard name (the first name given in the 
file), which is rather long and unambiguous, and optionally one or more nicknames. The hostnames for 
local machines also serve as commands in the directory /usr/hosts. If you put this directory in your search 
path, you can omit the rsh command and simply type the hostname, as shown in the second line of the 
SYNOPSIS section. 


OPTIONS 
-l username Executes the remote command as the specified user. 


—n Directs the input of rsh to /dev/null. 


FILES 
/etc/hosts 
/usr/hosts/* 


SEE ALSO 
rlogin(1C) 


BUGS 
If you are using csh(1) and put a rsh(1C) in the background without redirecting its input away from the ter- 
minal, it will block even if no reads are posted by the remote command. If you do not want input from the 
remote command, you should redirect the input of rsh to /dev/null using the —n option. 
You cannot run an interactive command (like rogue(6) or vi(1)); use rlogin(1C). 


Stop signals stop the local rsh process only. This is arguably wrong, but currently hard to fix for reasons 
too complicated to explain here. 
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NAME 
ruptime — show host status of local machines 


SYNOPSIS 
ruptime [ options } 


DESCRIPTION 
Ruptime prints a status line like uptime for each machine on the local network. It forms these lines from 
packets broadcast by each host on the network once a minute. 


If ruptime hasn’t received a status report from a machine for 5 minutes, it lists the machine as being down. 


Normally, ruptime sorts the listing by host name, but you can alter this order by specifying one of the 
options listed below. 


OPTIONS 
a Counts even those users who have been idle for an hour or more. 


a Sorts the display by load average. 
+t Sorts the display by up time. 
—u Sorts the display by number of users. 


FILES 
/usr/spool/rwho/whod.* data files 


SEE ALSO 
rwho(1iC) 
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NAME | 
rwho — who’s logged in on local machines 
SYNOPSIS 
rwho [ option ] 
DESCRIPTION 
The rwho command produces output similar to who for all machines on the local network. If rwho has not 


received a report from a machine for 5 minutes, it assumes the machine is down and does not report y users 
last known to be logged into that machine. 


If a users has not typed to the system for a minute or more, then rwho reports this idle time. If a user has 
not typed to the system for an hour or more, rwho omits that user from its output. 
OPTIONS 
—a Includes users who have not typed to the system for an hour or more. 
FILES 
/usr/spool/rwho/whod.* information about other machines 
SEE ALSO 
ruptime(1C), rwhod(8C) 


BUGS 
This is unwieldy when the number of machines on the local net is large. 
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secs — front end for SCCS (Source Code Control Subsystem) 


sees [—r ] [ —dpath ] [path ] command [flags Largs 


DESCRIPTION 


Sces is a front end to the SCCS programs that helps them mesh more cleanly with the rest of UNIX. It also 
includes the capability to run ‘‘set user id’’ to another user to provide additional protection. 


Basically, secs runs the command with the specified fags and args. Each argument is normally modified to 
be prepended with ‘‘SCCS/s.’’. 


Flags to be interpreted by the sccs program must be before the command argument. Flags to be passed to 
the actual SCCS program must come after the command argument. These flags are specific to the command 
and are discussed in the documentation for that command. 


Besides the usual SCCS commands, several ‘‘pseudo-commands’’ can be issued. These are: 


edit 
delget 


deledit 


Create 


fix 


clean 


check 


tell 


diffs 
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Equivalent to ‘‘get -e’’. 


Perform a delta on the named files and then get new versions. The new versions will 
have id keywords expanded, and will not be editable. The —m, —p, —r, —s, and —y flags 
will be passed to delta, and the —b, -c, —e, —i, —k, —l, -s, and —x flags will be passed to 
get. 


Equivalent to ‘‘delget’’ except that the ‘‘get’’ phase includes the ‘‘—e’’ flag. This option 
is useful for making a ‘‘checkpoint’’ of your current editing phase. The same flags will 
be passed to delta as described above, and all the flags listed for ‘‘get’’ above except —e 
and —k are passed to ‘‘edit’’. 


Creates an SCCS file, taking the initial contents from the file of the same name. Any flags 
to ‘“‘admin’’ are accepted. If the creation is successful, the files are renamed with a 
comma on the front. These should be removed when you are convinced that the SCCS 
files have been created successfully. 


Must be followed by a-—r flag. This command essentially removes the named delta, but 
leaves you with a copy of the delta with the changes that were in it. It is useful for fixing 
small compiler bugs, etc. Since it doesn’t leave audit trails, it should be used carefully. 


This routine removes everything from the current directory that can be recreated from 
SCCS files. It will not remove any files being edited. If the —b flag is given, branches 
are ignored in the determination of whether they are being edited; this is dangerous if you 
are keeping the branches in the same directory. 

This is the opposite of an ‘‘edit’’ or a “‘get -e’’. It should be used with extreme caution, 
since any changes you made since the get will be irretrievably lost. 

Gives a listing of all files being edited. If the —b flag is given, branches (i.e., SID’s with 
two or fewer components) are ignored. If the —u flag is given (with an optional argu- 
ment) then only files being edited by you (or the named user) are listed. 

Like ‘‘info’’ except that nothing is printed if nothing is being edited, and a non-zero exit 
Status is returned if anything is being edited. The intent is to have this included in an 
“‘install’’ entry in a makefile to insure that everything is included into the SCCS file 
before a version is installed. 

Gives a newline-separated list of the files being edited on the standard output. Takes the 
—b and —u flags like ‘‘info’’ and ‘‘check’’. 

Gives a ‘‘diff’’ listing between the current version of the program(s) you have out for 
editing and the versions in SCCS format. The —r, —c, —i, —x, and —t flags are passed to 
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get; the —I, —s, —e, —f, —h, and —b options are passed to diff. The —C flag is passed to diff 
as -C. 


print This command prints out verbose information about the named files. 


The —r flag runs sccs as the real user rather than as whatever effective user secs is ‘‘set user id’’ to. The 
~d flag gives a root directory for the SCCS files. The default is the current directory. The —p flag defines 
the pathname of the directory in which the SCCS files will be found; ‘‘SCCS’’ is the default. The —p flag 
differs from the —d flag in that the —d argument is prepended to the entire pathname and the —p argument is 
inserted before the final component of the pathname. For example, ‘‘sccs —d/x —py get a/b’ will convert to 
“get /x/a/y/s.b’’. The intent here is to create aliases such as ‘‘alias syssccs sccs -d/usr/src’’ which will be 
used as ‘“‘syssccs get cmd/who.c’’. Also, if the environment variable PROJECT is set, its value is used to 
determine the —d flag. If it begins with a slash, it is taken directly; otherwise, the home directory of a user 
of that name is examined for a subdirectory ‘‘src’’ or ‘‘source’’. If such a directory is found, it is used. 


Certain commands (such as admin) cannot be run ‘‘set user id’’ by all users, since this would allow anyone 
to change the authorizations. These commands are always run as the real user. 


EXAMPLES 


To get a file for editing, edit it, and produce a new delta: 


sccs get -e file.c 
ex file.c 
sccs delta file.c 


To get a file from another directory: 
SCCS —p/usr/src/sccs/s. get CC.C 
or 
sccs get /usr/src/sccs/s.cc.c 
To make a delta of a large number of files in the current directory: 
sccs delta *.c 
To get a list of files being edited that are not on branches: 
sccs info —b 
To delta everything being edited by you: 
sccs delta ‘sccs tell —u” 
In a makefile, to get source files from an SCCS file if it does not already exist: 


SRCS = <list of source files> 
$(SRCS): 
sccs get $(REL) $@ 


SEE ALSO 


BUGS 


admin(SCCS), chghist(SCCS), comb(SCCS), delta(SCCS), get(SCCS), help(SCCS), prt(SCCS), 
rmdel(SCCS), secsdiff(SCCS), what(SCCS) 
Eric Allman, An Introduction to the Source Code Control System 


It should be able to take directory arguments on pseudo-commands like the SCCS commands do. 
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NAME 
script — make typescript of terminal session 
SYNOPSIS 
script [—a] [file ] 
DESCRIPTION 
Script makes a typescript of everything printed on your terminal. The typescript is written to file, or 
appended to file if the —a option is given. It can be sent to the line printer later with Ipr. If no filename is 
given, the typescript is saved in the file typescript. 
The script ends when the forked shell exits. 


This program is useful when using a crt and a hard-copy record of the dialog is desired, as for a student 
handing in a program that was developed on a crt when hard-copy terminals are in short supply. 


BUGS 
Script places everything in the log file. This is not what the naive user expects. 
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NAME 
sed — stream editor 
SYNOPSIS 
sed [—n ] [—e script] [—f sfile ] [file]... 
DESCRIPTION | 
Sed copies the named files (standard input default) to the standard output, edited according to a script of 
commands. The —f option causes the script to be taken from file sfile; these options accumulate. If there is 
just one —e option and no —f’s, the flag —-e may be omitted. The —n option suppresses the default output. 
A script consists of editing commands, one per line, of the following form: 
{address [, address] ] function [arguments] 


In normal operation sed cyclically copies a line of input into a pattern space (unless there is something left 
after a ‘D’ command), applies in sequence all commands whose addresses select that pattern space, and at 
the end of the script copies the pattern space to the standard output (except under —n) and deletes the pat- 
tern space. 


An address is either a decimal number that counts input lines cumulatively across files, a ‘$’ that addresses 
the last line of input, or a context address, ‘/regular expression/’, in the style of ed(1) modified thus: 
The escape sequence ‘\n’ matches a newline embedded in the pattern space. 
A command line with no addresses selects every pattern space. 
A command line with one address selects each pattern space that matches the address. 


A command line with two addresses selects the inclusive range from the first pattern space that matches the 
first address through the next pattern space that matches the second. (If the second address is a number less 
than or equal to the line number first selected, only one line is selected.) Thereafter the process is repeated, 
looking again for the first address. 


Editing commands can be applied only to non-selected pattern spaces by use of the negation function ‘!’ 
(below). . 


In the following list of functions the maximum number of permissible addresses for each function is indi- 
cated in parentheses. 


An argument denoted text consists of one or more lines, all but the last of which end with ‘\’ to hide the 
newline. Backslashes in text are treated like backslashes in the replacement string of an ‘s’ command, and 
may be used to protect initial blanks and tabs against the stripping that is done on every script line. 


An argument denoted efile or wfile must terminate the command line and must be preceded by exactly one 
blank. Each wile is created before processing begins. There can be at most 10 distinct wfile arguments. 


(1) a\ 
text ; 
Append. Place text on the output before reading the next input line. 


(2) b label 
Branch to the ‘:’ command bearing the label. If label is empty, branch to the end of the script. 


(2) c\ 

text 
Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address range, place 
text on the output. Start the next cycle. 


(2)d Delete the pattern space. Start the next cycle. 
(2)D _ Delete the initial segment of the pattern space through the first newline. Start the next cycle. 
(2)g Replace the contents of the pattern space by the contents of the hold space. 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


SED(1) 


UNIX Programmer’s Manual SED (1) 


(2)G Append the contents of the hold space to the pattern space. 
(2)h — Replace the contents of the hold space by the contents of the pattern space. 
(2)H Append the contents of the pattern space to the hold space. 


(1)i\ 
text 
Insert. Place text on the standard output. 


(2)n Copy the pattern space to the standard output. Replace the pattern space with the next line of 
input. 

(2)N Append the next line of input to the pattern space with an embedded newline. (The current line 
number changes.) 

(2)p __ Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first newline to the standard output. 

(1)q Quit. Branch to the end of the script. Do not start a new cycle. 


(2)r rfile 
Read the contents of rfile. Place them on the output before reading the next input line. 

(2) s/regular expression/replacement/flags 
Substitute the replacement string for instances of the regular expression in the pattern space. Any 
character may be used instead of ‘/’. For a fuller description see ed(1). Flags is zero or more of 


g Global. Substitute for all nonoverlapping instances of the regular expression rather than 
just the first one. 
p Print the pattern space if a replacement was made. 


w wfile Write. Append the pattern space to wyile if a replacement was made. 


(2) t label 
Test. Branch to the ‘:’ command bearing the label if any substitutions have been made since the 
most recent reading of an input line or execution of a ‘t’. If label is empty, branch to the end of 
the script. 

(2) w wfile 
Write. Append the pattern space to le. 

(2)x Exchange the contents of the pattern and hold spaces. 


(2) y/string1/string2/ 
Transform. Replace all occurrences of characters in string] with the corresponding character in 
string2. The lengths of string] and string2 must be equal. 


(2)! function : 
Don’t. Apply the function (or group, if function is ‘{’) only to lines not selected by the 
address(es). 


~ (QO): label 


This command does nothing; it bears a label for ‘b’ and ‘t’ commands to branch to. 
(1)= Place the current line number on the standard output as a line. 
(2){ Execute the following commands through a matching ‘}’ a when the pattern space is selected. 
(0) An empty command is ignored. 


SEE ALSO 
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NAME 
sendbug — mail a system bug report to 4bsd-bugs 

SYNOPSIS 
sendbug [ address ] 

DESCRIPTION 
Bug reports sent to ‘4bsd-bugs@Berkeley EDU’ are intercepted by a program which expects bug reports to 
conform to a standard format. Sendbug is a shell script to help the user compose and mail bug reports in 
the correct format. Sendbug works by invoking the editor specified by the environment variable ED/TOR 
on a temporary copy of the bug report format outline. The user must fill in the appropriate fields and exit 
the editor. The default editor is vi(1). Sendbug then mails the completed report to ‘4bsd- 
bugs@Berkeley.EDU’ or the address specified on the command line. 

FILES 


/usr/ucb/bugformat — contains the bug report outline 


SEE ALSO 
vi(1), environ(7), sendmail(8) 
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NAME 
sh, for, case, if, while, : :, » break, continue, cd, eval, exec, exe export, login, read, readonly, set, shift, 
times, trap, umask, wait - command language 


SYNOPSIS 
sh [ —ceiknrstuvx ] [ arg }... 


DESCRIPTION 
Sh is a command programming language that executes commands read from a terminal or a file. See invo- 
cation for the meaning of arguments to the shell. 


Commands. 

A simple-command is a sequence of non blank words separated by blanks (a blank is a tab or a space). 
The first word specifies the name of the command to be executed. Except as specified below the remaining 
words are passed as arguments to the invoked command. The command name is passed as argument 0 (see 
execve(2)). The value of a simple-command is its exit status if it terminates normally or 200+status if it 
terminates abnormally (see sigvec(2) for a list of status values). 


A pipeline is a sequence of one or more commands separated by |. The standard output of each command 
but the last is connected by a pipe(2) to the standard input of the next command. Each command is run as 
a separate process; the shell waits for the last command to terminate. 


A list is a sequence of one or more pipelines separated by ;, &, && or || and optionally terminated by ; or 
&. ; and & have equal precedence which is lower than that of && and ||, && and || also have equal pre- 
cedence. A semicolon causes sequential execution; an ampersand causes the preceding pipeline to be exe- 
cuted without waiting for it to finish. The symbol && (||) causes the list following to be executed only if 
the preceding pipeline returns a zero (non zero) value. Newlines may appear in a list, instead of semi- 
colons, to delimit commands. 


A command is either a simple-command or one of the following. The value returned by a command is that 

of the last simple-command executed in the command. 

for name [in word ...] do list done 
Each time a for command is executed name is set to the next word in the for word list. If in word 
.. is omitted, in "$@" is assumed. Execution ends when there are no more words in the list. 

case word in [ pattern [ | pattern }... ) list 33] + CSAC 
A case command executes the list associated with the first pattern that matches word. The form of 
the patterns is the same as that used for filename generation. 

if list then list [ elif list then list] ... [else list] fi | 
The list following if is executed and if it returns zero the list following then is executed. Other- 
wise, the list following elif is executed and if its value is zero the list following then is executed. 
Failing that the else list is executed. 


while list (do list] done 
A while command repeatedly executes the while list and if its value is zero executes the do list; 
otherwise the loop terminates. The value returned by a while command is that of the last executed 
command in the do list. until may be used in place of while to negate the loop termination test. 


(list) Execute list in a subshell. 

{ list }_ list is simply executed. 

The following words are only recognized as the first word of a command and when not quoted. 
if then else elif fi case in esac for while unl do done { } 


Command substitution. 
The standard output from a command enclosed in a pair of back quotes ( *) may be used as part or all of a 
word; trailing newlines are removed. 
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Parameter substitution. 
The character $ is used to introduce substitutable parameters. Positional parameters may be assigned 
values by set. Variables may be set by writing 


name =value { name=value } ... 


$ {parameter} 
A parameter is a sequence of letters, digits or underscores (a name), a digit, or any of the charac- 
ters * @#? —$!. The value, if any, of the parameter is substituted. The braces are required only 
when parameter is followed by a letter, digit, or underscore that is not to be interpreted as part of 
its name. If parameter is a digit, it is a positional parameter. If parameter is * or @ then all the 
positional parameters, starting with $1, are substituted separated by spaces. $0 is set from argu- 
ment zero when the shell is invoked. 


$ {parameter —word} 
If parameter is set, substitute its value; otherwise substitute word. 


$ {parameter =word} 
If parameter is not set, set it to word; the value of the parameter is then substituted. Positional 
parameters may not be assigned to in this way. 


$ {parameter ? word} 
If parameter is set, substitute its value; otherwise, print word and exit from the shell. If word is 
omitted, a standard message is printed. 


$ {parameter +word} 
If parameter is set, substitute word; otherwise substitute nothing. 


In the above word is not evaluated unless it is to be used as the substituted string. (So that, for example, 
echo ${d—“pwd’} will only execute pwd if d is unset.) 


The following parameters are automatically set by the shell. 


# =‘ The number of positional parameters in decimal. 

- Options supplied to the shell on invocation or by set. 

a The value returned by the last executed command in decimal. 
$ The process number of this shell. 

8 The process number of the last background command invoked. 


The following parameters are used but not set by the shell. 


HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see execution). 

MAIL If this variable is set to the name of a mail file, the shell informs the user of the arrival of 
mail in the specified file. 

PS1 Primary prompt string, by default ’$ ’. 

PS2 Secondary prompt string, by default ’> ’. 

IFS Internal field separators, normally space, tab, and newline. IFS is ignored if sh is run- 
ning as root or if the effective user id differs from the real user id. 


Blank interpretation. 

After parameter and command substitution, any results of substitution are scanned for internal field separa- 
tor characters (those found . SIFS) and split into distinct arguments where such characters are found. 
Explicit null arguments ("" or “’) are retained. Implicit null arguments (those resulting from parameters 
that have no values) are inne 


File name generation. 

Following substitution, each command word is scanned for the characters +, ? and [. If one of these char- 
acters appears, the word is regarded as a pattern. The word is replaced with alphabetically sorted filenames 
that match the pattern. If no filename is found that matches the pattern, the word is left unchanged. The 


May 5, 1986 INTEGRATED SOLUTIONS 4.3 BSD 2 


SH (1) 


UNIX Programmer's Manual SH (1) 


Character . at the start of a filename or ae following a /, and the character /, must be matched 
explicitly. 


* Matches any string, including the null string. 
? Matches any single character. . 
[..] | Matches any one of the characters enclosed. A pair of characters rales by — matches any 


character lexically between the pair. 


Quoting. 
The following characters have a special meaning to the shell and cause termination of a word unless 
quoted. 


; & ( ) | < > newline space tab 


A character may be quoted by preceding it with a \. \newline is ignored. All characters enclosed between 
a pair of quote marks (°’), except a single quote, are quoted. Inside double quotes ("") parameter and 
command substitution occurs and \ quotes the characters \“ " and $. 


"$*" is equivalent to "$1 $2..." whereas 

"$@" is equivalent to "$1" "$2" .... 

Prompting. 

When used interactively, the shell prompts with the value of PS1 before reading a command. If at any time 
a newline is typed and further input is needed to complete a command, the sccoudaty prompt ($PS2) is 
issued. 


Input output. 

Before a command is executed its input and output may be redirected using a special notation interpreted 
by the shell. The following may appear anywhere in a simple-command or may precede or follow a com- 
mand and are not passed on to the invoked command. Substitution occurs before word or digit is used. 


<word Use file word as standard input (file descriptor Q). 


>word Use file word as standard output (file descriptor 1). If the file does not exist, it is created; other- 
wise it is truncated to zero length. 


>>word Use file word as standard output. If the file exists, output is appended (by seeking to the end); oth- 
erwise the file is created. 


<< word The shell input is read up to a line the same as word, or end of file. The resulting document 
becomes the standard input. If any character of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parameter and command substitution occurs, \newline 
is ignored, and \ is used to quote the characters \$ ° and the first character of word. 

< & digit . 
The standard input is duplicated from file descriptor digit; see dup(2). Similarly for the standard 
Output using >. 

<&— The standard input is closed. Similarly for the standard output using >. 


If one of the above is preceded by a digit, the file descriptor created is that specified by the digit (instead of 
the default 0 or 1). For example, 


wo 2>&1 


creates file descriptor 2 to be a duplicate of file descriptor 1. 


If a command is followed by & then the default standard input for the command is the empty file 
(/dev/null).. Otherwise, the environment for the execution of a command contains the file descriptors of the 
invoking shell as modified by input output specifications. 
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Environment. 

The environment is a list of name-value pairs that is passed to an executed program in the same way as a 
normal argument list; see execve(2) and environ(7). The shell interacts with the environment in several 
ways. On invocation, the shell scans the environment and creates a parameter for each name found, giving 
it the corresponding value. Executed commands inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of these affects the environment unless the export 
command is used to bind the shell’s parameter to the environment. The environment seen by any executed 
command is thus composed of any unmodified name-value pairs originally inherited by the shell, plus any 
modifications or additions, all of which must be noted in export commands. 


The environment for any simple-command may be augmented by prefixing it with one or more assignments 
tO parameters. Thus these two lines are equivalent 


TERM=450 cmd args 
(export TERM; TERM=450; cmd args) 


If the —k flag is set, all keyword arguments are placed in the environment, even if the occur after the com- 
mand name. The following prints ’a=b c’ and ’c’: 

echo a=b c 

set —k 

echo a=bc 


Signals. 
The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by 
&; otherwise signals have the values inherited by the shell from its parent. (But see also trap.) 


Execution. 
Each time a command is executed the above substitutions are carried out. Except for the ’special com- 
mands’ listed below a new process is created and an attempt is made to execute the command via an 
execve(2). 


The shell parameter $PATH defines the search path for the directory containing the command. Each alter- 
native directory name is separated by a colon (:). The default path is :/bin:/usr/bin. If the command name 
contains a /, the search path is not used. Otherwise, each directory in the path is searched for an executable 
file. If the file has execute permission but is not an a.out file, it is assumed to be a file containing shell 
commands. A subshell (i.e., a separate process) is spawned to read it. A parenthesized command is also 
executed in a subshell. 


Special commands. 
The following commands are executed in the shell process and except where specified no input output 
redirection is permitted for such commands. 


# For non-interactive shells, everything following the # is treated as a comment, i.e. the rest of the 
line is ignored. For interactive shells, the # has no special effect. 


: No effect; the command does nothing. 

; fle Read and execute commands from file and retum. The search path $PATH is used to find the 
directory containing file. 

break [7] 
Exit from the enclosing for or while loop, if any. If n is specified, break 7 levels. 

continue [ 7} 
Resume the next iteration of the enclosing for or while loop. If} n is specified, resume at the n-th 
enclosing loop. 

cd [arg] 
Change the current directory to arg. The shell parameter $HOME is the default arg. 

eval [arg ...] 
The arguments are read as input to the shell and the resulting command(s) executed. 

exec [arg ...] 
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The command specified by the arguments is executed in place of this shell without creating a new 
process. Input output arguments may appear and if no other arguments are given cause the shell 
input output to be modified. 
exit [7] ; 
Causes a non interactive shell to exit with the exit status specified by n. If n is omitted, the exit 
. Status is that of the last command executed. (An end of file will also exit from the shell.) 
export [name ...} 
The given names are marked for automatic export to the environment of subsequently-executed 
commands. If no arguments are given, a list of exportable names is printed. 
login (arg...) 
Equivalent to ’exec login arg ...’. 
read name ... . 
One line is read from the standard input; successive words of the input are assigned to the vari- 
ables name in order, with leftover words to the last variable. The return code is 0 unless the end- 
of-file is encountered. 
readonly [ name ... ] 
The given names are marked readonly and the values of the these names may not be changed by 
subsequent assignment. If no arguments are given, a list of all readonly names is printed. 
set [—eknptuvx [arg...]] 
—e If non interactive, exit immediately if a command fails. 
-k All keyword arguments are placed in the environment for a command, not just those that 
precede the command name. 
-n = Read commands but do not execute them. 
-t Exit after reading and executing one command. 
—u _—« Treat unset variables as an error when substituting. 
~v __ Print shell input lines as they are read. 
-x Print commands and their arguments as they are executed. 
- Turn off the —x and —v options. 


These flags can also be used upon invocation of the shell. The current set of flags may be found in 
$-. 


Remaining arguments are positional parameters and are assigned, in order, to $1, $2, etc. If no 
arguments are given, the values of all names are printed. 


shift | The positional parameters from $2... are renamed $1... 
times Print the accumulated user and system times for processes run from the shell. 


trap [arg] [n]... 
Arg is a command to be read and executed when the shell receives signal(s) n. (Note that arg is 
scanned once when the trap is set and once when the trap is taken.) Trap commands are executed 
in order of signal number. If arg is absent, all trap(s) m are reset to their original values. If arg is 
the null string, this signal is ignored by the shell and by invoked commands. If n is 0, the com- 
mand arg is executed on exit from the shell, otherwise upon receipt of signal n as numbered in 
sigvec(2). Trap with no arguments prints a list of commands associated with each signal number. 


umask [ nnn ] 
The user file creation mask is set to the octal value nnn (see umask(2)). If nnn is omitted, the 
current value of the mask is printed. 


wait [”] 
Wait for the specified process and report its termination status. If n is not given, all currently 
active child processes are waited for. The return code from this command is that of the ‘Process 
waited for. 
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Invocation. 

If the first character of argument zero is —, commands are read from $HOME/. profile, if such a file exists. 
Commands are then read as described below. The following flags are interpreted by the shell when it is 
invoked. 

—C String _If the —c flag is present, commands are read from string . 


-s If the —s flag is present or if no arguments remain then commands are read from the standard 
input. Shell output is written to file descriptor 2. 
-i If the —i flag is present or if the shell input and output are attached to a terminal (as told by 


gtty) then this shell is interactive. In this case the terminate signal SIGTERM (see sigvec(2)) 
is ignored (so that ’kill 0’ does not kill an interactive shell) and the interrupt signal SIGINT is 
Caught and ignored (so that wait is interruptible). In all cases SIGQUIT is ignored by the 
shell. 


The remaining flags and arguments are described under the set command. 


$HOME/.profile 
/tmp/sh* 
/dev/null 


SEE ALSO 


csh(1), test(1), execve(2), environ(7) 


DIAGNOSTICS 


BUGS 


Errors detected by the shell, such as syntax errors cause the shell to return a non zero exit status. If the 
Shell is being used non interactively then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also exit). 


If << is used to provide standard input to an asynchronous process invoked by &, the shell gets mixed up 
about naming the input document. A garbage file /tmp/sh* is created, and the shell complains about not 
being able to find the file by another name. 
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NAME 
size — size of an object file 
SYNOPSIS 
size [ object vs ] : 
DESCRIPTION | 
Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their sum in hex 
and decimal, of each object-file argument. If no file is specified, size prints the size of a.out. 


SEE ALSO 
a.out(5) 
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NAME 
sleep — suspend execution for an interval 


SYNOPSIS 
sleep seconds 


DESCRIPTION 
Sleep suspends execution for the specified number of seconds. It is used to execute a command after a cer- 
tain amount of time as in: 
(sleep 105; command) & 
or to execute a command every so often, as in: 


while true 
do 
command 
sleep 37 
done 


SEE ALSO ; 
setitimer(2), alarm(3C), sleep(3) 


BUGS 
Seconds must be less than 2,147,483,647. 
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NAME | 
soelim — eliminate .so’s from nroff input 
SYNOPSIS 
soelim [ file ... } 
DESCRIPTION 
Soelim reads the specified files or the standard input and performs the textual inclusion ordered by the 
nroff directives of the form 
SO filename 
To be executed by soelim, these directives must appear at the beginning of input lines. This inclusion 
method is useful since programs such as tbl do not normally include other files. Soelim allows the place- 
ment of individual tables in separate files to be run as a part of a large document. 
Soelim interprets an argument consisting of a single minus (—) as a filename corresponding to the standard 
input. - . 
Note that inclusion can be suppressed by using ‘”’ instead of *.’, ie. 
“so /usr/lib/tmac.s 
EXAMPLE 
soelim exum?.n | tbl | nroff—ms | col | Ipr 
SEE ALSO 
colert(1), more(1) 
BUGS 


The format of the source commands must involve no strangeness — exactly one blank must precede and no 
blanks follow the filename. 
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NAME 
sort — sort or merge files 


SYNOPSIS 
sort [—mubdfinrtx ] [+pos] [—pos2]]... [-o name ][—T directory] { name }... 


DESCRIPTION 
Sort sorts lines of all the named files together and writes the result on the standard output. The name ‘~’ 
means the standard input. If no input files are named, the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating 
sequence. The ordering is affected globally by the following options, one or more of which may appear. 


b _Ignore leading blanks (spaces and tabs) in field comparisons. 
d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons. 
f Fold upper case letters onto lower case. 


Ignore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 


mn __ An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more digits 
with optional decimal point, is sorted by arithmetic value. Option n implies option b. 


r Reverse the sense of comparisons. 
tx ‘Tab character’ separating fields is x. 


The notation +pos] —pos2 restricts a sort key to a field beginning at pos] and ending just before pos2. 
Pos! and pos2 each have the form m.n, optionally followed by one or more of the flags bdfinr, where m 
tells a number of fields to skip from the beginning of the line and n tells a number of characters to skip 
further. If any flags are present they override all the global ordering options for this key. If the b option is 
in effect n is counted from the first nonblank in the field; b is attached independently to pos2. A missing .n 
means .0; a missing —pos2 means the end of the line. Under the —tx option, fields are strings separated by 
x; otherwise fields are nonempty nonblank strings separated by blanks. 


When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. Lines 
that otherwise compare equal are ordered with all bytes significant. 


These option arguments are also understood: 


Cc Check that the input file is sorted according to the ordering rules; give no output unless the file is out 
of sort. 


m Merge only, the input files are already sorted. 


0 The next argument is the name of an output file to use instead of the standard output. This file may 
be the same as one of the inputs. 


The next argument is the name of a directory in which temporary files should be made. 


u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not partici- 
pate in this comparison. 


EXAMPLES 
Print in alphabetical order all the unique spellings in a list of words. Capitalized words differ from uncapi- 
talized. 
sort —u +0f +0 list | 
Print the password file (passwd(5)) sorted by user id number (the 3rd colon-separated field). 


sort —t: +2n /etc/passwd 
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Print the first instance of each month in an already sorted file of (month day) entries. The options -um | 
with just one input file make the choice of a unique representative from a set of equal lines predictable. 


sort —um +0 —1 dates 


FILES , 
/usr/tmp/stm*, /tmp/* first and second tries for temporary files 

SEE ALSO | 
uniq(1), comm(1), rev(1), join(1) 

- DIAGNOSTICS 

Comments and exits with nonzero status for various trouble conditions and for disorder discovered under 
option —c. 

BUGS 


Very long lines are silently truncated. 
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NAME 


sortbib — sort bibliographic database 


SYNOPSIS 


sortbib [ —s KEYS ] database ... 


DESCRIPTION 


Sortbib sorts files of records containing refer key-letters by user-specified keys. Records may be 
separated by blank lines, or by .{ and .] delimiters, but the two styles may not be mixed together. This pro- 
gram reads through each database and pulls out key fields, which are sorted separately. The sorted key 
fields contain the file pointer, byte offset, and length of corresponding records. These records are delivered 
using disk seeks and reads, so sortbib may not be used in a pipeline to read standard input. 


By default, sortbib alphabetizes by the first %A and the %D fields, which contain the senior author and 
date. The —s option is used to specify new KEYS. For instance, -sATD will sort by author, title, and date, 
while —sA+D will sort by all authors, and date. Sort keys past the fourth are not meaningful. No more than 
16 databases may be sorted together at one time. Records longer than 4096 characters will be truncated. 


Sortbib sorts on the last word on the %A line, which is assumed to be the author’s last name. A word in 
the final position, such as ‘‘jr.’’ or ‘‘ed.’’, will be ignored if the name beforehand ends with a comma. 
Authors with two-word last names or unusual constructions can be sorted correctly by using the nroff con- 
vention ‘‘\0’’ in place of a blank. A %Q field is considered to be the same as %A, except sorting begins 
with the first, not the last, word. Sortbib sorts on the last word of the %D line, usually the year. It also 
ignores leading articles (like ‘‘A’’ or ‘‘The’’) when sorting by titles in the %T or %J fields; it will ignore 
articles of any modern European language. If a sort-significant field is absent from a record, sortbib places 
that record before other records containing that field. 


SEE ALSO 


BUGS 


refer(1), addbib(1), roffbib(1), indxbib(1), lookbib(1) 


Records with missing author fields should probably be sorted by title. 
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NAME 
_ spell, spellin, spellout — find one errors 
SYNOPSIS 
. spell [-v] (—b] [—x] [-d Alist ] [—s Astop ] [—h spellhist } [ file}... 


spellin [ list ] 
spellout [—d ] list 


DESCRIPTION 

| Spell collects words from the named documents, and looks them up in a spelling list. Words that neither 
occur among nor are derivable (by applying certain inflections, prefixes or suffixes) from words in the spel- _ 
ling list are printed on the standard output. If no files are named, words are collected from the standard 
input. 
Spell ignores most troff, tbl and eqn(1) constructions. 


Under the —v option, all words not literally in the spelling list are printed, and plausible derivations from 
spelling list words are indicated. 


Under the —b option, British spelling is checked. Besides preferring centre, colour, speciality, travelled, 
etc., this option insists upon -ise in words like standardise, Fowler and the OED to the contrary notwith- 
standing. - 


Under the —x option, every plausible stem is printed with ‘=’ for each word. 


The spelling list is based on many sources. While it is more haphazard than an ordinary dictionary, it is 
also more effective with proper names and popular technical words. Coverage of the specialized vocabu- 
laries of biology, medicine and chemistry i is light. 


The auxiliary files used for the spelling list, stop list, and history file may be specified by arguments follow- — 
ing the —d, —s, and —h options. The default files are indicated below. Copies of all output may be accumu- 
lated in the history file. The stop list filters out misspellings (e.g. thier=thy—y+ier) that would otherwise 
pass. . 


Two routines help maintain the hash lists used by spell. Both expect a set of words, one per line, from the 
standard input. Spellin combines the words from the standard input and the preexisting list file and places a 

new list on the standard output. If no list file is specified, the new list is created from scratch. Spellout 

looks up each word from the standard input and prints on the standard output those that are missing from 

(or present on, with option —d) the hashed list file. For example, to verify that hookey is not on the default 

spelling list, add it to your own private list, and then use it with spell, 


echo hookey | spellout /usr/dict/hlista 
echo hookey | spellin /usr/dict/hlista > myhlist 
spell -—d myhlist huckfinn 


FILES 
/usr/dict/hlist{ab] hashed spelling lists, American & British, default for —d 
/usr/dict/hstop hashed stop list, default for —s 
‘dev/null history file, default for —h 
/emp/spell. $$+* temporary files 
/usr/lib/spell 
SEE ALSO 
deroff(1), sort(1), tee(1), sed(1) 
‘BUGS 


The spelling list’s coverage is uneven; new installations will probably wish to monitor the output for 
several months to gather local additions. 
British spelling was done by an American. 
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NAME 

spline — interpolate smooth curve 
SYNOPSIS | 

spline [ option } ... 


DESCRIPTION 
Spline takes pairs of numbers from the standard input as abcissas and ordinates of a function. It produces a 
similar set, which is approximately equally spaced and includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists and Engineers, 2nd ed., 349ff) has 
two continuous derivatives, and sufficiently many points to look smooth when plotted, for example by 

graph(1G). 
OPTIONS 
. Spline recognizes the following options, each as a separate argument. 
-a Supplies abscissas automatically (they are missing from the input). Spacing is given by the next 
argument, or is assumed to be 1 if next argument is not a number. 


-k The constant k used in the boundary value computation 
= ky, Ya = Wyn-1 


is set by the next argument. By default k = 0. 


-—n Space output points so that approximately n intervals occur between the lower and upper x limits. 
(Default n = 100.) 


—p Make output periodic, i.e. match derivatives at ends. First and last input values should normally 
agree. 
-x Next 1 (or 2) arguments are lower (and upper) x limits. Normally these limits are calculated from the 
data. Automatic abcissas start at lower limit (default 0). 
SEE ALSO 
graph(1G), plot(1G) 
DIAGNOSTICS 
When data is not strictly monotone in x, spline reproduces the input without interpolating extra points. 


BUGS 
A limit of 1000 input points is enforced silently. 
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NAME 
split — split a file into pieces 


~ SYNOPSIS 


split [—n ] [file [ name } ] 

DESCRIPTION 

| Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto a set of output files. 
The name of the first output file is name with aa appended, and so on lexicographically. If no output name 
is given, x is default. 


If no input file is given, or if — is given in its stead, then the standard input file is used. 
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NAME 

strings — find the printable strings in a object, or other binary, file 
SYNOPSIS 

strings [ options } file ... 


DESCRIPTION 
Strings looks for ascii strings in a binary file. A string is any sequence of 4 or more printing characters 
ending with a newline or a null. 


Without the — option, strings looks for asxii strings only in the initialized data space of object files. 
Strings is useful for identifying random object files and many other things. 


OPTIONS 
—0 Introduces each string with its offset in the file (in octal). 


~—number 
Uses number as the minimum string length rather than 4. 


~ Extends strings’ search beyond the initialized data space of object files. 


SEE ALSO 
od(1) 


BUGS 
The algorithm for identifying strings is primitive. 
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NAME 
strip — remove symbols and relocation bits 
SYNOPSIS 
strip name ... 
DESCRIPTION 
Strip removes the symbol table and relocation bits ordinarily attached to the output of the assembler and 
- loader. You can use strip to save space after a program has been debugged. 
The effect of strip is the same as use of the —s option of Id. | 
FILES 
/tmp/stm? temporary file 
SEE ALSO 
ld(1) 
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NAME 

struct — structure Fortran programs 
SYNOPSIS 

struct [ options ] file 
DESCRIPTION 

Struct translates the Fortran program specified by file (standard input default) into a Ratfor program. 

Wherever possible, Ratfor control constructs replace the original Fortran. Statement numbers appear only 

where still necessary. Ratfor makes cosmetic changes, including changing Hollerith strings into quoted 

strings and relational operators into symbols (.e.g. ".GT." into ">"). Ratfor indents the output appropri- 
ately. 
OPTIONS 
—a Turns sequences of else ifs intc a non-ratfor switch of the form 
switch 
{ case pred1: code 
case pred2: code 
case pred3: code 
default: code 
} 
Struct tests the case predicates in order and executes the code appropriate to only one case. This 
generalized form of switch statement does not occur in Ratfor. 

—b Generates goto’s instead of multilevel break statements. 

—cn Increments successive labels in the output program by the nonzero integer n (1 by default). 

—en If n is O (default), places code within a loop only if it can lead to an iteration of the loop. If n is 
nonzero, —e admits a small code segments to a loop if otherwise the loop would have exits to 
several places including the segment, and the segment can be reached only from the loop. ‘Small’ 
is close to, but not equal to, the number of statements in the code segment. Values of n under 10 
are suggested. 

-i Does not turn computed goto statements into switches. (Ratfor does not turn switches back into 
computed goto statements.) 

—n Generates goto’s instead of multilevel next statements. 

—S Accepts input in standard format, i.e., comments are specified by ac, C, or * in column 1, and 
continuation lines are specified by a nonzero, nonblank character in column 6. Normally input is 
in the form accepted by f77(1). 

—tn Makes the nonzero integer n the lowest valued label in the output program (default 10). 

FILES 
/tmp/struct* 
/usr/lib/struct/* 
SEE ALSO 
f77(1) 
BUGS 


Struct knows Fortran 66 syntax, but not full Fortran 77. 

If an input Fortran program contains identifiers which are reserved words in Ratfor, the structured version 
of the program will not be a valid Ratfor program. 

The labels generated cannot go above 32767. 

If you get a goto without a target, try —e. 
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NAME | 

stty — set terminal options 
SYNOPSIS 

stty [ option...) 
DESCRIPTION 


Stty sets certain /O options on the current output terminal, placing its output on the diagnostic output. 
With no argument, it reports the speed of the terminal and the settings of the options which are different 


from their defaults. Use of one of the following options modifies the output as described: 


All normally used option settings are reported. 


everything Everything stty knows about is printed. 


speed 


cooked 
cbreak 


—cbreak 
—nl 

ni 

echo 
~—echo 
Icase 
—Icase 
tandem 


The terminal speed alone is printed on the standard output. 
The terminal (window) sizes are printed on the standard output, first rows and then columns. 


The option strings are selected from the following set: 


allow even parity input 

disallow even parity input 

allow odd parity input 

disallow odd parity input 

raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed back) 
negate raw mode 

same as ‘—raw’ 

make each character available to read(2) as received; no erase and kill processing, but all 
other processing (interrupt, suspend, ...) is performed 

make characters available to read only when newline is received 

allow carriage return for new-line, and output CR-LF for carriage return or new-line 


‘accept only new-line to end lines 


echo back every character typed 

do not echo characters 

map upper case to lower case 

do not map case 

enable flow control, so that the system sends out the stop character when its internal queue is 
in danger of overflowing on input, and sends the start character when it is ready to accept 
further input 

disable flow control 

replace tabs by spaces when printing - 

preserve tabs 

set erase and kill characters to # and @ 


For the following commands which take a character argument c, you may also specify c as the ‘“‘u’’ or 
‘tundef’’, to set the value to be undefined. A value of ‘“*x’’, a 2 character sequence, is also interpreted as a 
control character, with ‘‘*?’’ representing delete. 


erase c 
kill c 
intr c 
quit c 
Start c 
stop c 
eof c 
brk c 
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set erase character to c (default ‘#’, but often reset to “H.) 

set kill character to c (default ‘@’, but often reset to “U.) 

set interrupt character to c (default DEL or *? (delete), but olen reset to "Cc 
set quit character to c (default control \.) 

set start character to c (default control Q.) 

set stop character to c (default control S.) 

set end of file character to c (default control D.) 

set break character to c (default undefined.) This character is an additional character causing | 
wakeup. 
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cr0 cr1 cr2 cr3 
. select style of delay for carriage retum (see ioctI(2)) 
nlo nll nl2 nl3 
select style of delay for linefeed 
tab0 tab1 tab2 tab3 
select style of delay for tab 
ff0 ff1 select style of delay for form feed 


bs0 bs1 


tty33 
tty37 
vt05 
dec 


300 
ti700 
tek 

0 


select style of delay for backspace 


set all modes suitable for the Teletype Corporation Model 33 terminal. 

set all modes suitable for the Teletype Corporation Model 37 terminal. 

set all modes suitable for Digital Equipment Corp. VTOS terminal 

set all modes suitable for Digital Equipment Corp. operating systems users; (erase, kill, and 
interrupt characters to “?, “U, and “C, decctlq and ‘‘newcrt’’.) 

set all modes suitable for a General Electric TermiNet 300 

set all modes suitable for Texas Instruments 700 series terminal 

set all modes suitable for Tektronix 4014 terminal 

hang up phone line immediately 


50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 


TOWS 7 


Set terminal baud rate to the number given, if possible. (These are the speeds supported by the 


DH-11 interface). 


The terminal size is recorded as having n rows. 


columns 7 The terminal size is recorded as having n columns. 


cols 1 


is an alias for columns. 


A teletype driver which supports the job control processing of csh(1) and more functionality than the basic 
driver is fully described in tty(4). The following options apply only to it. 


new 
crt 

crtbs 
prterase 
crterase 
—crterase 
ertkill 
—ertkill 
ctlecho 


—ctlecho 
decctlq 


—decctlq 


tostop 
—tostop 
tilde 
~tilde 
flusho 
—flusho 
pendin 


—pendin 
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Use new driver (switching flushes typeahead). 

Set options for a CRT (ertbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) 

Echo backspaces on erase characters. . 

For printing terminal echo erased characters backwards within ‘‘\’’ and ‘‘/’’. 

Wipe out erased characters with ‘“backspace-space-backspace.”’ 

Leave erased characters visible; just backspace. 

Wipe out input on like kill ala crterase. 

Just echo line kill character and a newline on line kill. 

Echo control characters as ‘‘“x’’ (and delete as ‘‘*?’’.) Print two backspaces following the 
EOT character (control D). 

Control characters echo as themselves; in cooked mode EOT (control-D) is not echoed. 


After output is suspended (normally by *S), only a start character (normally “Q) will restart it. 
This is compatible with DEC’s vendor supplied systems. 


After output is suspended, any character typed will restart it; the start character will restart out- 
put without providing any input. (This is the default.) 

Background jobs stop if they attempt terminal output. 

Output from background jobs to the terminal is allowed. 

Convert ‘‘~’’ to ‘**’’ on output (for Hazeltine terminals). 

Leave poor ‘‘~’’ alone. 

Output is being discarded usually because user hit control O (internal state bit). 

Output is not being discarded. . 

Input is pending after a switch from cbreak to cooked and will be re-input when a read 
becomes pending or more input arrives (internal state bit). 

Input is not pending. 
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Passes all 8 bits through on input, in any mode. | 

Strips the 0200 bit on input except in raw mode. 

Start/stop output on carrier transitions (not implemented). 
Return error if write attempted after carrier drops. 

Send output characters without any processing. 

Do normal output processing, inserting delays, etc. 

Don’t send hangup signal if carrier drops. 

Send hangup signal to control process group when carrier drops. 
Diablo style etx/ack handshaking (not implemented). 


The following special characters are applicable only to the new teletype driver and are not normally 


changed. 
susp c 
dsusp c 
rprnt c 
flush c 
werase c 
Inext c 


SEE ALSO 


set suspend process character to c (default control Z). 

set delayed suspend process character to c (default control Y). 
set reprint line character to c (default control R). 

set flush output character to c (default control O). 

set word erase character to c (default control W). 

set literal next character to c (default control V). 


ioctl(2), tabs(1), tset(1), tty(4) 
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NAME 
style — analyze writing style of a document 
SYNOPSIS 
style [ options | file ... 
DESCRIPTION 
Style analyzes the surface characteristics of the writing style of a document. It reports on readability, sen- 


tence length and structure, word length and usage, verb type, and sentence openers. Because style runs 
deroff before looking at the text, formatting header files should be included as part of the input. 


OPTIONS 
—a Prints all sentences with their length and readability index. 


—e Prints all sentences that begin with an expletive. 

-lnum Prints all sentences longer than nwm. 

-mli_ _— Causes deroff to skip lists, should be used if the document contains many lists of non-sentences. 
-mm Overrides —ms as the default macro package. 

-p Prints all sentences that contain a passive verb. 

-P Prints parts of speech of the words in the document. 

-rnum Prints all sentences whose readability index is greater than num. 


SEE ALSO 
deroff(1), diction(1) 


BUGS . 
Use of non-standard formatting macros may cause incorrect sentence breaks. 


April 29, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


SU(1) UNIX Programmer’s Manual _ SU (1) 


NAME 
su — substitute user id temporarily 

SYNOPSIS 
su [ options } [ userid ] 

DESCRIPTION 
Su demands the password of the specified userid, and if it is given, changes to that userid and invokes the 
Shell sh(1) or csh(1) without changing the current directory. The user environment is unchanged except 
for HOME and SHELL, which are taken from the password file for the user pene substituted (see 
environ(7)). The new user ID stays in force until the Shell exits. 


If no userid is specified, ‘‘root’’ is assumed. Only users in the ‘‘wheel’’ group (group 0) can su to “‘root’’, 
even with the root password. To remind the super-user of his responsibilities, the Shell substitutes ‘#’ for 
its usual prompt. 


OPTIONS 
—f Prevents csh(1) from executing the .cshrc file, thus ae su Start up faster. 


- Simulates a full login. 


SEE ALSO 
sh(1), esh(1) 
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NAME 
sum — sum and count blocks in a file 


SYNOPSIS 
sum file 


DESCRIPTION 
Sum calculates and prints a 16-bit checksum for the named file. It also prints the number of blocks in the 
file. Use sum to look for bad spots or to validate a file communicated over some transmission line. 


SEE ALSO 
we(1) 


DIAGNOSTICS 
‘Read error’ is indistinguishable from end of file on most devices. Check the block count. 
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- NAME 
symorder — rearrange name list 
SYNOPSIS . 
symorder orderlist symbolfile 
DESCRIPTION 
Orderlist is a file listing symbols found i in symbolfile, with one symbol per line. 


Symorder updates symbolfile in place by putting the requested symbols first in the symbol table, in the 
order specified. To do this, symorder swaps the old symbols in the required spots eo the new ones. If 
symorder cannot find all the order symbols, it generates an error. 


This program was specifically designed to cut down on the overhead of getting sacle from /vmunix. 


SEE ALSO 
nlist(3) 
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NAME 
sysline — display system status on status line of a terminal 


SYNOPSIS 
sysline [ options ] 

DESCRIPTION 
Sysline runs in the background and periodically displays system status information on the status line of the 
terminal. Not all terminals contain a status line. Those that do include the h19, concept 108, Ann Arbor 
Ambassador, vt100, Televideo 925/950 and Freedom 100. If no flags are given, sysline displays the time 
of day, the current load average, the change in load average in the last 5 minutes, the number of users (fol- 
lowed by a ‘u’), the number of runnable process (followed by a ‘r’), the number of suspended processes 
(followed by a ‘s’), and the users who have logged on and off since the last status report. Finally, if new 
mail has arrived, a summary of it is printed. If there is unread mail in your mailbox, an asterisk will appear 
after the display of the number of users. The display is normally in reverse video (if your terminal supports 
this in the status line) and is right justified to reduce distraction. Every fifth display is done in normal video 
to give the screen a chance to rest. 
If you have a file named .who in your home directory, then the contents of that file is printed first. One 


common use of this feature is to alias chdir, pushd, and popd to place the current directory stack in “/.who 
after it changes the new directory. 


OPTIONS 
—-b Beep once every half hour and twice every hour, just like those obnoxious watches you keep 
hearing. 
—Cc Clear the status line for 5 seconds before each redisplay. 
—d Debug mode -- print status line data in human readable format. 
-D Print out the current day/date before the time. 


—e Print out only the information. Do not print out the control commands necessary to put the 
information on the bottom line. This option is useful for putting the output of sysline onto 
the mode line of an emacs window. 


—h Print out the host machine’s name after the time. —i Print out the process id of the sysline 
process onto standard output upon startup. With this information you can send the alarm 
signal to the sysline process to cause it to update immediately. sysline writes to the standard 
error, SO you can redirect the standard output into a file to catch the process id. 


—H remote Print the load average on the remote host remote. If the host is down, or is not sending out 
rwhod packets, then the down time is printed instead. If the prefix "ucb" is present, then it is 


removed. 

-j Force the sysline output to be left justified even on terminals capable of cursor movement on 
the status line. 

—] Don’t print the names of people who log in and out. 

—-m Don’t check for mail. 

—p Don’t report the number of process which are runnable and suspended. 

-r Don’t display in reverse video. 

+N Update the status line every N seconds. The default is 60 seconds. 


Don’t print out diagnostic messages if something goes wrong when starting up. 


Print "short" form of line by left-justifying iff escapes are not allowed in the status line. 
Some terminals (the Televideos and Freedom 100 for example) do not allow cursor move- 
ment (or other "intelligent" operations) in the status line. For these terminals, sysline 


dt 
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normally uses blanks to cause right-justification. This fiag will disable the adding of the 
blanks. 


—Ww Window mode -- print the status on the current line of the terminal, suitable for use inside a 
one line window. 


If you have a file .syslinelock in your home directory, then sysline will not update its statistics and write on 
your screen, it will just go to sleep for a minute. This is useful if you want to momentarily disable sysline. 
Note that it may take a few seconds from the time the lock file is created until you are Sere that sys- 
line will not write on the screen. 


FILES | 
/etc/utmp names of people who are logged in 
/dev/kmem contains process table 
/usr/spool/rwho/whod.* who/uptime information for remote hosts 
${HOME}/.who information to print on bottom line 
${HOME}/.syslinelock — when it exists, sysline will not print 
BUGS 


If you interrupt the display then you may find your cursor missing or stuck on the status line. The best 
thing to do is reset the terminal. 
If there is too much for one line, the excess is thrown away. 
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NAME 


systat — display system statistics on a crt 


SYNOPSIS 


systat [ —display ] [ refresh-interval ] 


DESCRIPTION 


Systat displays various system statistics in a screen oriented fashion using the curses screen display library, 
curses(3X). 

While systat is running the screen is usually divided into two windows (an exception is the vmstat display 
which uses the entire screen). The upper window depicts the current system load average. The informa- 
tion displayed in the lower window may vary, depending on user commands. The last line on the screen is 
reserved for user input and error messages. 

By default systat displays the processes getting the largest percentage of the processor in the lower win- 
dow. Other displays show swap space usage, disk i/o statistics (a la iostat(1)), virtual memory statistics (a 
la vmstat(1)), network ‘‘mbuf’’ utilization, and network connections (a la netstat(1)). 

Input is interpreted at two different levels. A ‘‘global’’ command interpreter processes all keyboard input. 
If this command interpreter fails to recognize a command, the input line is passed to a per-display com- 
mand interpreter. This allows each display to have certain display-specific commands. 


Certain characters cause immediate action by systat. These are 
‘L Refresh the screen. 


‘G Print the name of the current ‘‘display”’ being shown in the lower window and the refresh inter- 
val. 


L Stop systat. 


Move the cursor to the command line and interpret the input line typed as a command. While 
entering a command the current character erase, word erase, and line kill characters may be used. 


The following commands are interpreted by the ‘‘global’’ command interpreter. 


help 

Print the names of the available displays on the command line. 
load . 

Print the load average over the past 1, 5, and 15 minutes on the command line. 
stop 


Stop refreshing the screen. 

[ start ] [ number ] 
Start (continue) refreshing the screen. If a second, numeric, argument is provided it is interpreted 
as a refresh interval (in seconds). Supplying only a number will set the refresh interval to this 


| value. 

quit 
Exit systat. (This may be abbreviated to ¢.) 

The available displays are: 

pigs 
Display, in the lower window, those processes resident in main memory and getting the largest 
portion of the processor (the default display). When less than 100% of the processor is scheduled 
to user processes, the remaining time is accounted to the ‘‘idle’’ process. 

iostat 


Display, in the lower window, statistics about processor use and disk throughput. Statistics on 
processor use appear as bar graphs of the amount of time executing in user mode (‘‘user’’), in user 
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swap 


mbufs 


vmstat 
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mode running low priority processes (‘‘nice’’), in system mode (‘‘system’’), and idle (‘‘idle’’). 
Statistics on disk throughput show, for each drive, kilobytes of data transferred, number of disk 
transactions performed, and average seek time (in milliseconds). This information may be 
displayed as bar graphs or as rows of numbers which scroll downward. Bar graphs are shown by 
default; commands specific to this display are discussed below. 


Display, in the lower window, swap space in use on each swap device configured. Two sets of bar 
graphs are shown. The upper graph displays swap space allocated to pure text segments (code), 
the lower graph displays space allocated to stack and data segments. Allocated space is sorted by 
its size into buckets of size dmmin, dmmin*2, dmmin*4, up to dmmax (to reflect allocation poli- 
cies imposed by the system). The disk segment size, in sectors, is displayed along the left hand 
side of the text, and data and stack graphs. Space allocated to the user structure and page tables is 
not currently accounted for. 


Display, in the lower window, the number of mbufs allocated for particular uses, i.e. data, socket 
structures, etc. 


Take over the entire display and show a (rather crowded) compendium of statistics related to vir- 
tual memory usage, process scheduling, device interrupts, system name translation cacheing, disk 
i/o, etc. 


The upper left quadrant of the screen shows the number of users logged in and the load average 
over the last one, five, and fifteen minute intervals. Below this line are statistics on memory utili- 
zation. The first row of the table reports memory usage only among active processes, that is 
processes that have run in the previous twenty seconds. The second row reports on memory usage 
of all processes. The first column reports on the number of physical pages claimed by processes. 
The second column reports the number of physical pages that are devoted to read only text pages. 
The third and fourth columns report the same two figures for virtual pages, that is the number of 
pages that would be needed if all processes had all of their pages. Finally the last column shows 
the number of physical pages on the free list. 


Below the memory display is the disk usage display. It reports the number of seeks, transfers, and 
number of kilobyte blocks transferred per second averaged over the refresh period of the display 
(by default, five seconds). For some disks it also reports the average milliseconds per seek. Note 
that the system only keeps statistics on at most four disks. 


Below the disk display is a list of the average number of processes (over the last refresh interval) 
that are runnable (‘r’), in page wait (‘p’), in disk wait other than paging (‘d’), sleeping (‘s’), and 
swapped out but desiring to run (‘w’). Below the queue length listing is a numerical listing and a 
bar graph showing the amount of system (shown as ‘=’), user (shown as ‘>’), nice (shown as ‘-’), 
and idle time (shown as ‘ ’). | 


At the bottom left are statistics on name translations. It lists the number of names translated in the 


- previous interval, the number and percentage of the translations that were handled by the system 


wide name translation cache, and the number and percentage of the translations that were handled 
by the per process name translation cache. . 


Under the date in the upper right hand quadrant are statistics on paging and swapping activity. 
The first two columns report the average number of pages brought in and out per second over the 
last refresh interval due to page faults and the paging daemon. The third and fourth columns 
report the average number of pages brought in and out per second over the last refresh interval due 
to swap requests initiated by the scheduler. The first row of the display shows the average number 


of disk transfers per second over the last refresh interval; the second row of the display shows the 


average number of pages transferred per second over the last refresh interval. 
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Below the paging statistics is a line listing the average number of total reclaims (’Rec’), intransit 
blocking page faults (‘It’), swap text pages found in free list (‘F/S’), file system text pages found 
in free list (‘F/F’), reclaims from free list (“RFL’), pages freed by the clock daemon (‘Fre’), and 
sequential process pages freed (‘SFr’) per second over the refresh interval. 


Below this line are statistics on the average number of zero filled pages (‘zf’) and demand filled 
text pages (‘xf’) per second over the refresh period. The first row indicates the number of requests 
that were resolved, the second row shows the number that were set up, and the last row shows the 
percentage of setup requests were actually used. Note that this percentage is usually less than 
100%, however it may exceed 100% if a large number of requests are actually used long after they 
were set up during a period when no new pages are being set up. Thus this figure is most interest- 
ing when observed over a long time period, such as | from boot time (see below on getting such a 
display). 


Below the page fill statistics is a column that lists the average number of context switches (‘Csw’), 
traps (‘Trp’), system calls (‘Sys’), interrupts (‘Int’), characters output to DZ ports using pseudo- 
DMA (‘Pdm’), page faults (‘Fit’), pages scanned by the page daemon (‘Scn’), and revolutions of 
the page daemon’s hand (‘Rev’) per second over the refresh interval. 


Running down the right hand side of the display is a breakdown of the interrupts being handled by 
the system. At the top of the list is the total interrupts per second over the time interval. The rest 
of the column breaks down the total on a device by device basis. Only devices that have inter- 
rupted at least Gnce since boot time are shown. 


netstat 
Display, in the lower window, network connections. By default, network servers awaiting 
requests are not displayed. Each address is displayed in the format ‘‘host.port’’, with each shown 
symbolically, when possible. It is possible to have addresses displayed numerically, limit the 
display to a set of ports, hosts, and/or protocols; see the list of commands below. 


Commands to switch between displays may be abbreviated to the minimum unambiguous prefix; for exam- 
ple, ‘‘io’’ for ‘‘iostat’’. Certain information may be discarded when the screen size is insufficient for 
display. For example, on a machine with 10 drives the iostat bar graph displays only 3 drives on a 24 line 
terminal. When a bar graph would overfiow the allotted screen space it is truncated and the actual value is 
printed ‘‘over top’’ of the bar. 


The following commands are specific to me iostat display; the minimum unambiguous prefix may be sup- 
plied. 


numbers . 
Show the disk i/o statistics in numeric form. Values are displayed in numeric columns which 
scroll downward. 


bars Show the disk i/o statistics in bar graph form (default). 
msps Toggle the display of average seek time (the default is to not display seek times). 
The following commands are specific to the vmstat display; the minimum Paes prefix may be sup- 


plied. 
boot Display cumulative statistics since the system was booted. 
run Display statistics as a running total from the point this command is given. 


time Display statistics averaged over the refresh interval (the default). 
zero _— Reset running statistics to zero. 


The following commands are common to each display which shows information about disk drives. These 
commands are used to select a set of drives to report on, should your system have more drives configured 
than can normally be displayed on the screen. 
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FILES 


BUGS 


- ignore [ drives ] 


Do not display information about the drives indicated. Multiple drives may be specified, 
separated by spaces. 

display [drives] 
Display information about the drives indicated. Multiple drives may be specified, separated by 
spaces. 

The following command is specific to the netstat display; the minimum unambiguous prefix may be sup- 

plied. 

all Toggle the displaying of server processes awaiting requests (this i is the equivalent of the —a nee to 
netstat(1)). 


numbers 
Display network addresses numerically. 


names Display network addresses symbolically. 


_ The remaining commands are common to displays which report network connections (currently only the 


netstat display). These commands may be used to select a specific set of connections for systat to report 
on. 


protocol 
Display only network connections using the indicated protocol (currently either ‘‘tcp’’ or ‘‘udp’’). 


ignore [items] 
Do not display information about connections associated with the specified hosts or ports. Hosts 
and ports may be specified by name (‘‘ucbmonet’’, ‘‘ftp’’), or numerically. Host addresses use 
the Internet dot notation (‘'128.32.0.9’’). Multiple items may be specified with a sa command 
by separating them with spaces. 


display [items] 
Display information about the connections associated with the specified hosts or ports. As for 
ignore , items may be names or numbers. 


show [ports|hosts] 
Show, on the command line, the currently selected protocols, hosts, and ports. Hosts and ports 
which are being ignored are prefixed with a ‘!’. If ports or hosts is supplied as an argument to 
show, then only the requested information will be displayed. 


reset Reset the port, host, and protocol matching mechanisms to the default (any protocol, port, or host). 


/vmunix for the namelist 

/dev/kmem for information in main memory 

/dev/drum _ for information about swapped out processes 
‘etc/hosts for host names 

/etc/networks for network names 

/etc/services for port names 


Takes 2-10 percent of the cpu. Certain displays presume a 24 line by 80 character terminal. The swap 
space display should account for space allocated to the user structure and page tables. The vmstat display 
looks out of place because it is (it was added in as a separate display rather than create a new program). 


The whole thing is pretty hokey and was included in the distribution under serious duress. 
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NAME 

tabs — set terminal tabs 
SYNOPSIS 

tabs [ option } [ terminal } 


DESCRIPTION 
Tabs sets the tabs on a variety of terminals. Tabs recognizes various terminal names given in term(7). 
The default is, however, suitable for most 300 baud terminals. 


OPTION 
—n Does not indent the left margin. Usually, the left margin is indented. 


SEE ALSO 
stty(1), term(7) 


BUGS 
It’s much better to use tset(1). 
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NAME 
tail - deliver the last part of a file 
SYNOPSIS 
tail ( options | [file ] 
DESCRIPTION 
Tail copies the named file to the standard output beginning at a designated place. If you do not specify a 
file, tail copies the standard input. 
OPTIONS | 
+number [Ibe] 
Begins copying at distance +number from the beginning of the file. —number 
-number [lbc] 
Begins copying number units from the end of the input. Tail counts number in units of lines, 
blocks or characters, according to the appended option I, b or c. When no units are specified, tail 
counts by lines. . 


-f Causes tail not to quit at end of file. Instead, tail waits and reads repeatedly in hopes that the file 
will grow. 


-r Causes tail to print lines from the end of the file in reverse order. By default, r prints the entire 
file this way. : 


SEE ALSO 
dd(1) head(1) 
BUGS 


Tail stores text specified from the end of the file in a buffer. Using a buffer limits the length of such 
copies. . 


Various kinds of anomalous behavior can happen with character special files. 
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NAME 
talk — talk to another user 


SYNOPSIS 


talk user [ ttyname } 


DESCRIPTION 


FILES 


Talk is a visual communication program which copies lines from your terminal to that of another user. 


If you wish to talk to someone on you own machine, then user is just the person’s login name. If you wish 
to talk to a user on another host, then user is of the form : 


host!user 
host.user 
host:user 
user@host 


The form user@host is perhaps preferred. 
If you want to talk to a user who is logged in more than once, the ttyname argument may be used to indi- 
cate the appropriate terminal name. 
When first called, it sends the message 

Message from TalkDaemon@his_machine... 

talk: connection requested by your_name@your_machine. 

talk: respond with: talk your_name@your_machine 
to the user you wish to talk to. At this point, the recipient of the message should reply by typing 

talk your_name@your_machine 
It doesn’t matter from which machine the recipient replies, as long as his login-name is the same. Once 
communication is established, the two parties may type simultaneously, with their output appearing in 
separate windows. Typing control L redraws the screen. Erase, kill, and word kill characters perform the 


same functions in talk as they do elsewhere. To exit, just type your interrupt character; talk moves the 
cursor to the bottom of the screen and restores the terminal. 


Users can use the mesg command to grant or deny permission to talk. By default, mesg permits talking. 
Certain commands, in particular nroff and pr(1), disallow messages in order to prevent messy output. 


/etc/hosts to find the recipient’s machine 
/etc/utmp to find the recipient’s tty 


SEE ALSO 


BUGS 


mail(1), mesg(1), who(1), write(1) 


The version of talk(1) released with 4.3BSD uses a protocol that is incompatible with the protocol used in 
the version released with 4.2BSD. 
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tar — tape archiver 


SYNOPSIS 


tar [ key] [ option ] | files ] 


DESCRIPTION 


Tar saves and restores multiple files on a single file (usually a magnetic tape, but it can be any file). Tar’s 
actions are controlled by the key argument. The key is a string of characters containing at most one func- 
tion letter and possibly one or more function modifiers. Other arguments to tar are file or directory names 
specifying which files to dump or restore. In all cases, appearance of a directory name refers to the files 
and (recursively) subdirectories of that directory. | 


Previous restrictions dealing with tar’s inability to properly handle blocked archives have been lifted. 


KEYS 


Function Letters 
The function portion of the key is specified by one of the following letters: 


Cc 


Create a new tape; writing begins on the beginning of the tape instead of after the last file. This 
command implies r. 


The named files are written on the end of the tape. The c function implies this. 


The names of the specified files are listed each time they occur on the tape. If no file argument is 
given, all of the names on the tape are listed. 


The named files are added to the tape if either they are not already there or have been modified 
since last put on the tape. 


The named files are extracted from the tape. If the named file matches a directory whose con- 
tents had been written onto the tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no file argument is given, the entire 
content of the tape is extracted. Note that if multiple entries specifying the same file are on the 
tape, the last one overwrites all earlier. 


Function Modifiers 
The following characters may be used in addition to the letter which selects the function desired. 


0, eeeg 9 


b 
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This modifier selects an alternate drive on which the tape is mounted. The default is drive 0 at 
1600 bpi, which is normally /dev/rmt8. 


Tar uses the next argument as the blocking factor for tape records. The default is 20 (the max- 
imum). This option should only be used with raw magnetic tape archives (See f above). The 
block size is determined automatically when reading tapes (key letters ‘x’ and ‘t’). 

Forces input and output blocking to 20 blocks per record. This option was added so that tar 
can work across a Communications channel where the blocking may not be maintained. 


Tar uses the next argument as the name of the archive instead of /dev/rmt?. If the name of the 
file is ‘—’, tar writes to standard output or reads from standard input, whichever is appropriate. 
Thus, tar can be used as the head or tail of a filter chain. Tar can also be used to move hierar- 
chies with the command . 

cd fromdir; tar cf - . | (cd todir; tar xf -) 
Force tar to follow symbolic links as if they were normal files or directories. Normally, tar 
does not follow symbolic links. . 


tells tar to complain if it cannot resolve all of the links to the files dumped. If this is not 
specified, no error messages are printed. 


tells tar not to restore the modification times. The modification time will be the time of 
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FILES 
/dev/rmt? 
/tmp/tar+ 


SEE ALSO 
tar(5) 


DIAGNOSTICS 
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extraction. 


On output, tar normally places information specifying owner and modes of directories in the 
archive. Former versions of tar, when encountering this information will give error message of 
the form 

"<name>/: cannot create". 
This modifier will suppress the directory information. 
This modifier says to restore files to their original modes, ignoring the present umask(2). 
Setuid and sticky information will also be restored to the super-user. 
Normally tar does its work silently. The v (verbose) option makes tar print the name of each 


file it treats preceded by the function letter. With the t function, the verbose option gives more 
information about the tape entries than just their names. 


Tar prints the action to be taken followed by filename, then wait for user confirmation. If a 
word beginning with ‘y’ is given, the action is done. Any other input means don’t do it. 


Performs a chdir(2) to the specified directory. This allows multiple directories not related by a 
close common parent to be archived using short relative path names. For example, to archive 
files from /usr/include and from /etc, one might use 

tar c -C /usr include -C / etc 


Tar prints messages about bad key characters and tape read/write errors. 
It complains if enough memory is not available to hold the link tables. 


BUGS 


There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The current limit on filename length is 100 characters. 

There is no way selectively to follow symbolic links. 

When extracting tapes created with the r or u options, directory modification times may not be set 


correctly. 
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NAME e* 
tbi — format tables for nroff or troff 
SYNOPSIS | 
tbl [ files}... 
DESCRIPTION | | : , 
Tbl is a preprocessor for formatting tables for nroff or troff(1). The input files are copied to the standard 


output, except for lines between .TS and .TE command lines, which are assumed to describe tables and are 
reformatted. For more information, see the tbl(1) reference manual. 


If no arguments are given, tbl reads the standard input. This means you can use it as a filter. When using 

tbl with eqn or neqn, place the tbl command first to minimize the volume of data passed through pipes. 
EXAMPLE 

As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 


.TS 
CSS 
ccs 
ccc 
Inn. 
Household Population 
Town\tHouseholds . 
\tNumber\tSize 
Bedminster\t789\t3.26 
Bernards Twp.\t3087\t3.74 
Bernardsville\t2018\t3.30 
Bound Brook\t3425\t3.04 
Branchburg\t1644\t3.49 
Bridgewater\t7897\t3.8 1 
Far Hills\t240\t3.19 
.TE | 

yields 

Household Population 
Town Households 
Number Size 
Bedminster | 789 3.26 
Bernards Twp. 3087 3.74 
Bernardsville 2018 = 3.30 
Bound Brook 3425 3.04 
Branchburg 1644 3.49 
Bridgewater 7897 3.81 
Far Hills 240 3.19 
SEE ALSO 
troff(1), eqn(1) 
M. E. Lesk, TBL. 
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NAME 
tc — photoypesetter simulator 

SYNOPSIS 
te [ options } [ file } 

DESCRIPTION 
Tc interprets its input (standard input default) as device codes for a Graphic Systems phototypesetter (cat). 
The standard output of tc is intended for a Tektronix 4015 (a 4014 terminal with ASCII and APL character 
sets). The sixteen typesetter sizes are mapped into the 4014’s four sizes; the entire TROFF character set is 
drawn using the 4014’s character generator, using overstruck combinations where necessary. An example 
of typical usage is: 

troff —t file | tc 


At the end of each page tc waits for a newline (empty line) from the keyboard before continuing on to the 
next page. In this wait state, you can use the following commands: 


e Suppresses the screen erase before the next page. 
SN Skips the next N pages. 
‘line — Sends line to the shell. 


Multiply the default aspect ratio, 1.5, of a displayed page by J/w. 


—pL Sets page length to L. L may include the scale factors p (points), i (inches), c (centimeters), and P 
(picas). The default is picas. 


—sN Skips the first N pages.- 
-t Does not wait between pages. Use this option when you direct output into a file. 


SEE ALSO 
troff(1), plot(1G) 
BUGS 
Font distinctions are lost. 
Te’s character set is limited to ASCII in just one size. 
The aspect ratio option is unbelievable. 
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NAME | 

tcopy — Copy a mag tape 
-SYNOPSIS 

teopy src [ dest ] 


~ DESCRIPTION 


Tcopy copies magnetic tapes. It makes only one assumption about the magnetic tape—that there are two 
tape marks at the end the tape. | 

If you specify a source tape src without a destination tape dest, tcopy prints information about the sizes of 
records and tape files. If you specify both a source tape and a destination tape, tcopy copies the source tape 
to the destination tape. The blocking on the destination tape will be identical to that used on the source 


tape. 
When copying a tape tcopy prints the same output it does when it prints record and tape file sizes. 


SEE ALSO 
mtio(4) 
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NAME 
tee — pipe fitting 
SYNOPSIS 
tee [ options } [ file}... 
DESCRIPTION 
Tee transcribes the standard input to the standard output and copies the input to the specified files. 
OPTIONS 
—a Appends the output to the files rather than overwriting them. 
-i Ignores interrupts. 
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NAME 
telnet — user interface to the TELNET protocol 


SYNOPSIS 
telnet [ host [ port] ] 


DESCRIPTION 
Telnet is used to communicate with another host using the TELNET protocol. If telnet is invoked without 
arguments, it enters command mode, indicated by its prompt (‘‘telnet>’’). In this mode, it accepts and exe- 
cutes the commands listed below. If it is invoked with arguments, it performs an open command (see 
below) with those arguments. 


Once a connection has been opened, telnet enters an input mode. The input mode entered will be either 
*‘character at a time’’ or ‘line by line’’ depending on what the remote system supports. 


In “‘character at a time’’ mode, most text typed is immediately sent to the remote host for processing. 


In ‘‘line by line’’ mode, all text is echoed locally, and (normally) only completed lines are sent to the 
remote host. The ‘‘local echo character’ (initially “‘“E’’) may be used to turn off and on the local echo 
(this would mostly be used to enter passwords without the password being echoed). 


In either mode, if the localchars toggle is TRUE (the default in line mode; see below), the user’s quit, intr, 
and flush characters are trapped locally, and sent as TELNET protocol sequences to the remote side. 
There are options (see toggle autoflush and toggle autosynch below) which cause this action to flush subse- 
quent output to the terminal (until the remote host acknowledges the TELNET sequence) and flush previ- 
ous terminal input (in the case of quit and intr). 

While connected to a remote host, telnet command mode may be entered by typing the telnet ‘‘escape 


character’’ (initially ‘‘*]’’). When in command mode, the normal terminal editing conventions are avail- 
able. 


COMMANDS 
The following commands are available. Only enough of each command to uniquely identify it need be 
typed (this is also true for arguments to the mode, set, toggle, and display commands). 


open host [ port ] 
Open a connection to the named host. If no port number is specified, telnet will attempt to contact 
a TELNET server at the default port. The host specification may be either a host name (see 
hosts(5)) or an Internet address specified in the “‘dot notation’’ (see inet(3N)). 


Close a TELNET session and return to command mode. 


Close any open TELNET session and exit telnet. An end of file (in command mode) will also 
Close a session and exit. 


Suspend telnet. This command only works when the user is using the esh(1). 


mode type 
Type is either line (for ‘‘line by line’’ mode) or character (for ‘‘character at a time’? mode). The 
remote host is asked for permission to go into the requested mode. If the remote host is capable of 
entering that mode, the requested mode will be entered. 


Status 
Show the current status of telnet. This includes the peer one is connected to, as well as the 
current mode. 


display [ argument... ] 
Displays all, or some, of the set and toggle values (see below). 
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? [ command } 
Get help. With no arguments, telnet prints a help summary. If a command is specified, telnet 
will print the help information for just that command. 


send arguments 
Sends one or more special character sequences to the remote host. The following are the argu- 
ments which may be specified (more than one argument may be specified at a time): 


escape 
Sends the current telnet escape character (initially ‘“*}’’). 


synch 
Sends the TELNET SYNCH sequence. This sequence causes the remote system to dis- 
card all previously typed (but not yet read) input. This sequence is sent as TCP urgent 
data (and may not work if the remote system is a 4.2 BSD system -- if it doesn’t work, a 
lower case ‘‘r’’ may be echoed on the terminal). 


brk 
Sends the TELNET BRK (Break) sequence, which may have significance to the remote 
system. 

ip 
Sends the TELNET IP (Interrupt Process) sequence, which should cause the remote sys- 
tem to abort the currently running process. 

ao 
Sends the TELNET AO (Abort Output) sequence, which should cause the remote sys- 
tem to flush all output from the remote system to the user’s terminal. 

ayt | | 
Sends the TELNET AYT (Are You There) sequence, to which the remote system may 
or may not choose to respond. 

éc 
Sends the TELNET EC (Erase Character) sequence, which should cause the remote sys- 
tem to erase the last character entered. 

el 
Sends the TELNET EL (Erase Line) sequence, which should cause the remote system to 
erase the line currently being entered. 

ga . 
Sends the TELNET GA (Go Ahead) sequence, which likely has no significance to the 
remote system. 

nop 
Sends the TELNET NOP (No OPeration) sequence. 

? 
Prints out help information for the send command. 

set argument value 


Set any one of a number of telnet variables to a specific value. The special value ‘‘off’’ turns off 
the function associated with the variable. The values of variables may be interrogated with the 
display command. The variables which may be specified are: 


echo 
This is the value (initially ‘““E’’) which, when in ‘‘line by line’’ mode, toggles between 
doing local echoing of entered characters (for normal processing), and suppressing echo- 
ing of entered characters (for entering, say, a password). 

escape 
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This is the telnet escape character (initially ‘‘*[’’) which causes entry into telnet com- 
. mand mode (when connected to a remote system). 
interrupt 
If telnet is in localchars mode (see toggle localchars below) and the interrupt character 
is typed, a TELNET IP sequence (see send ip above) is sent to the remote host. The ini- 
tial value for the interrupt character is taken to be the terminal’s intr character. 
quit 
If telnet is in localchars mode (see toggle localchars below) and the quit character is 
typed, a TELNET BRK sequence (see send brk above) is sent to the remote host. The 
initial value for the quit character is taken to be the terminal’s quit character. 


flushoutput 
If telnet is in localchars mode (see toggle localchars below) and the flushoutput charac- 
ter is typed, a TELNET AO sequence (see send ao above) is sent to the remote host. 
The initial value for the flush character is taken to be the terminal’s flush character. . 


erase 
If telnet is in localchars mode (see toggle localchars below), and if telnet is operating in 
“‘character at a time’’ mode, then when this character is typed, a TELNET EC sequence 
(see send ec above) is sent to the remote system. The initial value for the erase character 
is taken to be the terminal’s erase character. 
kill 
If telnet is in localchars mode (see toggle localchars below), and if telnet is operating in 
“‘character at a time’’ mode, then when this character is typed, a TELNET EL sequence 
(see send el above) is sent to the remote system. The initial value for the kill hae is 
taken to be the terminal’s kill character. 


If telnet is operating in ‘‘line by line’’ mode, entering this character as the first character 
on a line will cause this character to be sent to the remote system. The initial value of the 
eof character is taken to be the terminal’s eof character. 


toggle arguments... 
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Toggle (between TRUE and FALSE) various flags that control how telnet responds to events. 
More than one argument may be specified. The state of these flags may be interrogated with the 
display command. Valid arguments are: 


locaichars . . 

If this is TRUE, then the flush, interrupt, quit, erase, and kill characters (see set above) 
are recognized locally, and transformed into (hopefully) appropriate TELNET control 
sequences (respectively ao, ip, brk, ec, and el; see send above). The initial value for 
this toggle is TRUE in ‘‘line by line’’ mode, and FALSE in ‘‘character at a time’’ mode. 


autoflush — 
If autoflush and lobalchars are both TRUE, then when the ao, intr, or quit characters are 
recognized (and transformed into TELNET sequences; see set above for details), telnet 
refuses to display any data on the user’s terminal until the remote system acknowledges 
(via a TELNET Timing Mark option) that it has processed those TELNET sequences. 
The initial value for this toggle is TRUE if the terminal user had not done an "stty 
nofish", otherwise FALSE (see stty(1)). 


_ @autosynch 


If autosynch and localchars are both TRUE, then when either the intr or quit characters 
is typed (see set above for descriptions of the intr and quit characters), the resulting 
TELNET sequence sent is followed by the TELNET SYNCH sequence. This pro- 
cedure should cause the remote system to begin throwing away all previously typed 
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BUGS 


crmod 


debug 
options 


netdata 
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input until both of the TELNET sequences have been read and acted upon. The initial 
value of this toggle is FALSE. 


Toggle carriage return mode. When this mode is enabled, most carriage return characters 
received from the remote host will be mapped into a carriage return followed by a line 
feed. This mode does not affect those characters typed by the user, only those received 
from the remote host. This mode is not very useful unless the remote host only sends 
Carriage return, but never line feed. The initial value for this toggle is FALSE. 


Toggles socket level debugging (useful only to the superuser). The initial value for this 
toggle is FALSE. 


Toggles the display of some internal telnet protocol processing (having to do with TEL- 
NET options). The initial value for this toggle is FALSE. 


Toggles the display of all network data (in hexadecimal format). The initial value for 
this toggle is FALSE. 


Displays the legal toggle commands. 


There is no adequate way for dealing with flow control. 

On some remote systems, echo has to be turned off manually when in ‘‘line by line’ mode. 
There is enough settable state to justify a Jtelnetrc file. 

No capability for a .telnetrc file is provided. 


In “‘line by line’’ mode, the terminal’s eof character is only recognized (and sent to the remote system) 
when it is the first character on a line. 
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NAME | 
test — condition command 
SYNOPSIS 
test expr 
DESCRIPTION | 
Test evaluates the expression expr, and if its value is true then returns zero exit status; otherwise, a non 
zero exit status is returned. Test returns a non zero exit if there are no arguments. 
PRIMITIVES 
The following primitives are used to construct expr. 
~d file True if the file exists exists and is a directory. 
-f file True if the file exists and is not a directory. 
—n sl True if the length of the string s/] is nonzero. 
—r file True if the file exists and is readable. 
~s file True if the file exists and has a size greater than zero. 
—t[fildes] True if the open file whose file descriptor number is fildes (1 by default) is associated with a 
terminal device. 
Ww file True if the file exists and is writable. 
—z sl True if the length of string s/ is zero. 
nl -eqn2 True if the integers nJ and n2 are algebraically equal. 
nl —-gen2 Tre if integer n/ is greater than or equal to 22. 
nl —gt n2 True if integer nJ is greater than 72. 
nl —le n2 True if integer nJ is less than or equal to 2. 
nl —It n2 True if integer nJ is less than 72. 
al-nen2 True if integer nJ is not equal to 72. Any of the comparisons —ne, —gt, —ge, —It, or —le may 
be used in place of —eq. 
sl True if s] is not the null string. 
sl =s2 True if the strings s/ and s2 are equal. 
s]!=s2 ‘True if the strings s] and s2 are not equal. 
OPERATORS 
These primaries may be combined with the following operators: 
! Unary negation operator 
-a Binary and operator 
—0 Binary or operator 
(expr) parentheses for grouping. 


—a has higher precedence than —o. Note that all the operators and flags are separate arguments to test. 
Note also that parentheses are meaningful to the Shell and must be escaped. 


SEE ALSO 
~ sh(1), find(1) 
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NAME 
tftp — trivial file transfer program 


SYNOPSIS 
tftp [ host] 


DESCRIPTION 
Tftp is the user interface to the Internet TFTP (Trivial File Transfer Protocol), which allows users to 
transfer files to and from a remote machine. If you specify the remote host on the command line, tftp uses 
the specified host as the default host for future transfers (see the connect command below). 


COMMANDS : 
Once tftp is running, it issues the prompt tftp> and recognizes the following commands: 


ascii. Shorthand for "mode ascii" 
binary Shorthand for "mode binary” 


connect host-name [ port ] 
Sets the host (and optionally port) for transfers. Note that the TFTP protocol, unlike the FTP pro- 
tocol, does not maintain connections betweeen transfers; thus, the connect command does not 
actually create a connection, but merely remembers what host is to be used for transfers. You do 
not have to use the connect command; the remote host can be specified as part of the get or put 
commands. 


mode transfer-mode 
Sets the mode for transfers; transfer-mode may be one of ascii or binary. The default is ascii. 

get filename 

get remotename localname 

get file] file2 ... fileN 
Gets a file or set of files from the specified sources. Source can be in one of two forms: a 
filename on the remote host, if the host has already been specified, or a string of the form 
host filename to specify both a host and filename at the same time. If the latter form is used, the 
last hostname specified becomes the default for future transfers. 

put file 

put localfile remotefile 

put filel file2 ... fileN remote-directory 
Puts a file or set of files to the specified remote file or directory. The destination can be in one of 
two forms: a filename on the remote host, if the host has already been specified, or a string of the 
form host:filename to specify both a host and filename at the same time. If the latter form is used, 
the hostname specified becomes the default for future transfers. If the remote-directory form is 
used, the remote host is assumed to be a UNIX machine. _ 


quit Exits tftp. An end-of-file also exits. 


rexmt retransmission-timeout 
Sets the per-packet retransmission timeout, in seconds. 


status Shows current status. 


timeout total-transmission-timeout 
Sets the total transmission timeout, in seconds. 


trace Toggles packet tracing. 
verbose Toggles verbose mode. 


? [command-name ...]} 
Prints help information. 
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BUGS 7 | 
Because there is no user-login or validation within the TFTP protocol, the remote site will probably have 
some sort of file-access restrictions in place. The exact methods are specific to each site and therefore 
difficult to document here. . . 
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NAME 
time — time a command 


SYNOPSIS 
time command 


DESCRIPTION 
Time executes the given command, then prints the time elapsed during command execution, the time spent 
in the system, and the time spent in execution of the command. Times are reported in seconds. 


On a PDP-11, the execution time varies according to the kind of memory the program happens to use. The 
user time in MOS is often half what it is in core. 


Time prints times on the diagnostic output stream. 
Time is built in to csh(1), using a different output format. 


BUGS “ 
Elapsed time is accurate to the second, while the CPU times are measured to the 100th second. Thus the 
sum of the CPU times can be up to a second larger than the elapsed time. 


Time is a built-in command to csh(1), with a much different syntax. This command is available as 
“*foin/time’’ to csh users. 
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NAME 
tip, cu — connect to a remote system 


SYNOPSIS 
tip [ options | system-name 
tip [ options ] phone-number 
cu phone-number [ —t ] [—s speed] [—a acu] [I line ] [-#] 


DESCRIPTION 
Tip and cu establish a full-duplex connection to another machine, giving the appearance of being logged in 
directly on the remote cpu. It goes without saying that you must have a login on the machine (or 
equivalent) to which you wish to connect. The preferred interface is tip. The cu interface is included for 
those people attached to the ‘‘call UNIX’’ command of version 7. This manual page describes only tip. 
Typed characters are normally transmitted directly to the remote machine (which does the echoing as well). 
A tilde (‘’) appearing as the first character of a line is an escape signal. Tip recognizes the following set of 
escape characters. 

TILDE ESCAPE CHARACTERS 
“ Escapes to a shell (exiting the shell will return you to tip). 


> Copies file from local to remote. Tip prompts for the name of a local file to transmit. 


< Copies file from remote to local. Tip prompts first for the name of the file to be sent, then 
for a command to be executed on the remote machine. 


“| Pipes the output from a remote command to a local UNIX process. The command string 
sent to the local UNIX system is processed by the shell. 


“$ Pipes the output from a local UNIX process to the remote host. The command string sent to 
the local UNIX system is processed by the shell. . 
# Sends a BREAK to the remote system. For systems which don’t support the necessary ioctl 


call the break is simulated by a sequence of line speed changes and DEL characters. 
? Displays a summary of the tilde escapes. 
“c¢ [name] Changes directory to name (no argument implies change to your home directory). 
“D*. Drops the connection and exit (you may still be logged in on the remote machine). 


“pfrom [to] Sends a file to a remote UNIX host. The put command causes the remote UNIX system to 
run the command string “‘cat > ’to’’’, while tip sends it the ‘‘from”’ file. If the ‘‘to’’ file 
isn’t specified the ‘‘from’’ filename is used. This command is actually a UNIX specific ver- 
sion of the ‘‘">’’ command. 

“s Sets a variable (see the discussion below). 


“tfrom[to] Takes a file from a remote UNIX host. As in the put command the ‘‘to’’ file defaults to the 
“*from’’ filename if it isn’t specified. The remote host executes the command string ‘‘cat 
from’ ;echo “A’’ to send the file to tip. 


~“y _ Stops only the ‘‘local side’’ of tip (only available with job control); the ‘‘remote side’’ of 
tip, the side that displays output from the remote host, is left running. 
“Z Stops tip (only available with job control). 


Tip uses the file /etc/remote to find how to reach a particular system and to find out how it should operate 
while talking to the system; refer to remote(5) for a full description. 


_ When tip establishes a connection it sends out a connection message to the remote system; the ‘default 
_ value, if any, is defined in /etc/remote. 
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When tip prompts for an argument (e.g. during setup of a file transfer) the line typed may be edited with 
the standard erase and kill characters. A null line in response to a prompt, or an interrupt, will abort the 
dialogue and return you to the remote machine. 


Tip guards against multiple users connecting to a remote system by opening modems and terminal lines 
with exclusive access, and by honoring the locking protocol used by uucp(1C). 


During file transfers tip provides a running count of the number of lines transferred. When using the “> 
and “< commands, the eofread and eofwrite variables are used to recognize end-of-file when reading, and 
specify end-of-file when writing (see below). File transfers normally depend on tandem mode for flow 
control. If the remote system does not support tandem mode, echocheck may be set to indicate tip should 
synchronize with the remote system on the echo of each transmitted character. 


When tip must dial a phone number to connect to a system it will print various messages indicating its 
actions. Tip supports the DEC DN-11 and Racal-Vadic 831 auto-call-units; the DEC DF02 and DFO3, 
Ventel 212+, Racal-Vadic 3451, and Bizcomp 1031 and 1032 integral call unit/modems. 


OPTIONS 
—n Specifies baud rate n. Each system has a default baud rate with which to establish a connection. 


If this value is not suitable, you can specify the correct baud rate on the command line, as in: tip 
-300 mds 
-vV Displays values of variables as they are set. 
VARIABLES 


Tip maintains a set of variables that control its operation. Some of these variable are read-only to normal 
users (root is allowed to change anything of interest). Variables may be displayed and set through the ‘‘s’’ 
escape. The syntax for variables is patterned after vi(1) and Mail(1). Supplying all as an argument to the 
set command displays all variables readable by the user. Alternatively, the user may request display of a 
particular variable by attaching a ‘?’ to the end. For example escape? displays the current escape charac- 
ter. 


Variables are numeric, string, character, or boolean values. To set a boolean variable, just specify its 
name. You can reset boolean variables by prepending a ‘!’ to the name. To set other variable types, con- 
Catenate an ‘=’ and the value. The entire assignment must not have any blanks in it. You can use a single 
set command to interrogate as well as set a number of variables. Variables may be initialized at run time 
by placing set commands (without the “s prefix in a file .tiprc in one’s home directory). The —v option 
Causes tip to display the sets as they are made. Certain common variables have abbreviations. 


The following is a list of common variables, their abbreviations, and their default values. 


beautify 

(bool) Discard unprintable characters when a session is being scripted; abbreviated be. 
baudrate 

(num) The baud rate at which the connection was established; abbreviated ba. 
dialtimeout 


(num) When dialing a phone number, the time (in seconds) to wait for a connection to be esta- 
blished; abbreviated dial. 


echocheck 
(bool) Synchronize with the remote host during file transfer by waiting for the echo of the last 
character transmitted; default is off. 

eofread . 
(str) The set of characters which signify and end-of-tranmission during a “< file transfer com- 
mand; abbreviated eofr. 

eofwrite 
(str) The string sent to indicate end-of-transmission during a “> file transfer command; abbreviated 
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eofw. 

eol : 

(str) The set of characters which indicate an end-of-line. Tip will recognize escape characters 
only after an end-of-line. 

escape 

(char) The command prefix (escape) character; abbreviated es; default value is *~’. 

exceptions 
(str) The set of characters which should not be discarded due to the beautification switch; abbrevi- 
ated ex; default value is “‘\t\n\f\b”. — 

force | 
(char) The character used to force literal data transmission; abbreviated fo; default value is ‘*P’. 

framesize 

' (num) The amount of data (in bytes) to buffer between file system writes when receiving files; 
abbreviated fr. 

host 
(str) The name of the host to which you are connected; abbreviated ho. 

prompt 
(char) The character that indicates and end-of-line on the remote host; abbreviated pr; default 
value is ‘\n’. This value is used to synchronize during data transfers. The count of lines 
transferred during a file transfer command is based on recipt of this character. 

raise 
(bool) Upper case mapping mode; abbreviated ra; default value is off. When this mode is 
enabled, tip maps all lower case letters to upper case for transmission to the remote machine. 

raisechar . 

(char) The input character used to toggle upper case mapping mode; abbreviated rc; default value 
is ‘“A’. . 

record 
(str) The name of the file in which a session script is recorded; abbreviated rec; default value is 
“‘tip.record’’. 

script 
(bool) Session scripting mode; abbreviated sc; default is off. When script is true, tip records 
everything transmitted by the remote machine in the script record file specified in record. If the 
beautify switch is on, tip includes only printable ASCII characters (those characters betwee 040 
and 0177) in the script file. The variable exceptions is used to indicate characters which are an 
exception to the normal beautification rules. 

tabexpand 
(bool) Expand tabs to spaces during file transfers; abbreviated tab; default value is false. Tip 
expands each tab to 8 spaces. 

verbose 
(bool) Verbose mode; abbreviated verb; default is true. When verbose mode is enabled, tip prints 
messages while dialing, shows the current number of lines transferred during a file transfer opera- 
tions, and more. 

SHELL . . a 
(str) The name of the shell to use for the ~! command; default value is /bin/sh, or taken from the 
environment. 

HOME 


(str) The home directory to use for the “c command; default value is taken from the environment. 
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FILES 
/etc/remote global system descriptions 
/etc/phones global phone number data base 
${REMOTE} private system descriptions 
${PHONES} private phone numbers 
“/.tipre initialization file. 
/usr/spool/uucp/LCK..* lock file to avoid conflicts with uucp 
DIAGNOSTICS 
Diagnostics are, hopefully, self explanatory. 
SEE ALSO 
remote(5), phones(5) 
BUGS 


The full set of variables is undocumented and should, probably, be paired down. 
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NAME 
tk — paginator for the Tektronix 4014 

SYNOPSIS 
tk [ options ] { file ] 

DESCRIPTION | 
The output of tk is intended for a Tektronix 4014 terminal. Tk arranges for 66 lines to fit on the screen, 
divides the screen into N columns, and contributes an eight space page offset in the (default) single-column 
case. Tk collects and plots tabs, spaces, and backspaces when necessary. It interprets and plots Teletype 
Model 37 half- and reverse-line sequences, as well. At the end of each page tk waits for a newline (empty 
line) from the keyboard before continuing on to the next page. In this wait state, the command !command 
sends the command to the shell. 

OPTIONS | 
—pL Sets page length to L lines. 
—N Divides the screen into N columns and waits after the last column. 
-t Does not wait between pages. Use this option for directing output into a file. 

SEE ALSO 
pr(1) ; 
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NAME 


tn3270 — full-screen remote login to IBM VM/CMS 


SYNOPSIS 


tn3270 sysname 


DESCRIPTION 


FILES 


Tn3270 permits a full-screen, full-duplex connection from a VAX UNIX machine to an IBM machine run- 
ning VM/CMS giving the appearance of being logged in directly to the remote machine on an IBM 3270 
terminal. Of course you must have an account on the machine to which you wish to connect in order to log 
in. Tn3270 looks to the user in many respects like the Yale ASCII Terminal Communication System II. 
Tn3270 is actually a modification of the Arpanet TELNET user interface (see telnet(1)) that interprets and 
generates raw 3270 control streams. 


Emulation of the 3270 terminal is done in the Unix process. This emulation involves mapping 3270-style 
commands from the host into appropriate sequences to control the user’s terminal screen. Tn3270 uses 
curses(3x) and the /etc/termcap file to do this. The emulation also involves simulating the special 3270 
keyboard keys (program function keys, etc.) by mapping sequences of keystrokes from the ASCII key- 
board into appropriate 3270 control strings. This mapping is terminal dependent and is specified in a 
description file, /etc/map3270, (see map3270(5)) or in an environment variable MAP3270 (see mset(1)). 
Any special function keys on the ASCII keyboard are used whenever possible. If an entry for the user’s 
terminal is not found, tn3270 looks for an entry for the terminal type unknown. If this is not found, tn3270 
uses a default keyboard mapping (see map3270(5)). 


The first character of each special keyboard mapping sequence is either an ASCII escape (ESC), a control 
character, or an ASCII delete (DEL). If the user types an unrecognized function key sequence, tn3270 
sends an ASCII bell (BEL), or a visual bell if defined in the user’s termcap entry, to the user’s terminal and 
nothing is sent to the IBM host. 


If tn3270 is invoked without specifying a remote host system name, it enters local command mode, indi- 
cated by the prompt ‘‘tn3270>’’. In this mode, tn3270 accepts and executes the following commands: 


open * connect to a remote host 
close close the current connection 
status print connection status 

Zz suspend tn3270 

quit exit tn3270 

: print help information 


Other common telnet commands are not available in tn3270. Tn3270 command mode may also be 
entered, after connecting to a host, by typing a special escape character (typically control-C). 


While in command mode, any host login session is still alive but temporarily suspended. The host login 
session may be resumed by entering an empty line (press the RETURN key) in response to the command 
prompt. A session may be terminated by logging off the foreign host, or by typing ‘‘quit’’ or ‘‘close’’ 
while in local command mode. 


/etc/termcap 
/etc/map3270 


SEE ALSO 


mset(1), telnet(1c), termcap(3x), termcap(5), map3270(5) 
Yale ASCII Terminal Communication System II Program Description/Operator’s Manual (IBM SB30- 
1911) | 
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BUGS 
Performance is slow. Tn3270 uses system resources prodigiously. 


__ Tn3270 does not support all 3270 functions nor all Yale enhancements. 
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NAME 
touch — update date last modified of a file 


SYNOPSIS 
touch [ options } files 


DESCRIPTION 
Touch tries to set the modified date (the time when the file was last changed) of each file. If the file exists, 
touch reads a character from the file and writes it back to change the file’s date. If the specified file does 
not exist, touch usually tries to create it. 


OPTIONS 

—C Tells touch not to create the file if it does not exist. 

—f Tries to force the touch in spite of read and write permissions on a file. 
SEE ALSO 

utimes(2) 
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SYNOPSIS 
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tp — manipulate tape archive 


tp [ key} [ files] 


DESCRIPTION 


Tp saves and restores files on DECtape or magtape. Its actions are controlled by the key argument. The 
key is a string of characters containing at most one function letter and possibly one or more function 
modifiers. Other arguments to the command are file or directory names specifying which files are to be 
dumped, restored, or listed. In all cases, appearance of a directory name refers to the files and (recursively) 
subdirectories of that directory. 


Function Letters 


The function portion of the key is specified by one of the following letters: 


d Deletes the named files from the tape. At least one name argument must be given. This function 
is not permitted on magtapes. 

r Writes the named files on the tape. If files with the same names already exist, they are replaced. 
‘Same’ is determined by string comparison, so ‘./abc’ can never be the same as ‘/usr/dmr/abc’ 
even if ‘/usr/dmr’ is the current directory. If no file argument is given, ‘.’ is the default. 

t Lists the names of the specified files. If no file argument is given, the entire contents of the tape 
is listed. 

u Updates the tape. u is like r, but a file is replaced only if its modification date is later than the 
date stored on the tape; that is to say, if it has changed since it was dumped. u is the default com- 
mand if none is given. 

x Extracts the named files from the tape to the file system. The owner and mode are restored. If no 
file argument is given, the entire contents of the tape are extracted. 

Function Modifiers | 


The following characters may be used in addition to the letter which selects the function desired. 


0,...57 


c 
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Selects the drive on which the tape is mounted. For DECtape, x is default; for magtape ‘0’ is the 
default. 


Clears the tape directory before beginning so that a fresh dump can be made. Usable only with r 
and u. This option is assumed with magtape since it is impossible to selectively overwrite 
magtape. 


Use the first named file, rather than a tape, as the archive. This option currently acts like m; i.e. r 
implies c, and neither d nor u are permitted. 


Errors reading and writing the tape are noted, but no action is taken. Normally, errors cause a 
return to the command level. 


Specifies magtape as opposed to DECtape. 
Causes tp to type the name of each file it treats preceded by the function letter. (Normally tp 


does its work silently.) With the t function, v gives more information about the tape entries than 
just the name. 


Causes tp to pause before treating each file, type the indicative letter and the filename (as with v) 
and await the user’s response. Response y means ‘yes’, so the file is treated. Null response 
means ‘no’, and the file does not take part in whatever is being done. Response x means ‘exit’; 
the tp command terminates immediately. In the x function, files previously asked about have 


been extracted already. With r, u, and d no change has been made to the tape. 
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FILES 
/devitap? 
/dev/rmt? 


SEE ALSO 

ar(1), tar(1) 
DIAGNOSTICS 

"Phase error" means the file changed after it was selected for dumping, but before it was dumped. 
BUGS 

Tp treats a single file with several links to it as though it were several files. 


' Binary-coded control information makes magnetic tapes written by tp difficult to carry to other machines; 
tar(1) avoids the problem. 
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NAME 
tr — translate characters 


SYNOPSIS 
tr [—cds } [ string! [ string2 }] 


. DESCRIPTION 


Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string] are mapped into the corresponding characters of string2. When string? i iS 
short it is padded to the length of string] by duplicating its last character. 


In either string the notation a—b means a range of characters from a to b in increasing ASCII order. The 
character ‘\’ followed by 1, 2 or 3 octal digits stands for the character whose ASCII code is given by those 
digits. A ‘\’ followed by any other character stands for that character. 


The following example creates a list of all the words in ‘file1’ one per line in ‘file2’, where a word is taken 
to be a maximal string of alphabetics. The second string is quoted to protect ‘\’ from the Shell. 012 is the 
ASCII code for newline. | 


tr —cs A-Za—z ‘\012’ <file1 >file2 


OPTIONS 
-c Complements the set of characters in string] with respect to the universe of characters whose 
ASCII codes are 01 through 0377 octal. 


—d Deletes all input characters in string]. 
—S Squeezes all strings of repeated output characters that are in string2 to single characters. 


SEE ALSO 
ed(1), ascii(7), sesamal 1) 


BUGS . 
Tr will not handle ASCII NUL in string] or string2. It always deletes NUL from input. 
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FILES 
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troff, nroff — text formatting and typesetting 
SYNOPSIS 
troff [ options } [ files } 
nroff [ options } [ files } 
DESCRIPTION 
Troff formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter. Nroff for- 


mats files for typewriter-like devices. The Nroff/Troff User's Manual describes the capabilities of both 
nroff and troff. 


If no file argument is present, troff or nroff reads the standard input. An argument consisting of a single 
minus (—) is taken to be a filename corresponding to the standard input. 


If the file /usr/adm/tracct is writable, troff keeps phototypesetter accounting records there. The integrity of 
that file may be secured by making troff a ‘set user-id’ program. 


OPTIONS 
The options, which may appear in any order so long as they appear before the files, are: 


Reads standard input after the input files are exhausted. 


—olist Prints only pages whose page numbers appear in the comma-separated list of numbers and 
ranges. A range N—M means pages N through M; an initial -N means from the beginning to 
page N; and a final N— means from N to the end. 

—mname_  Prepends the macro file /usr/lib/tmac/tmac.name to the input files. 

—nN Numbers first generated page N. 

-q Invokes the simultaneous input-output mode of the rd request. 

—raN Sets register a (one-character) to N. 

—sN . Stops every N pages. Nroff will halt prior to every N pages (default N=1) to allow paper load- 
ing or changing, and will resume upon receipt of a newline. Troff will stop the photo- 
typesetter every N pages, produce a trailer to allow changing cassettes, and resume when the 
typesetter’s start button is pressed. 

Troff only 

-a Sends a printable ASCII approximation of the results to the standard output. 

—b Reports whether the phototypesetter is busy or available. No text processing is done. 

-f Refrains from feeding out paper and stopping phototypesetter at the end of the run. 

—Ffontdir The directory fontdir contains the font width tables instead of the default directory 
/usr/lib/fonts. You can use this option to produce output for devices besides the photo- 
typesetter. 

—pN Prints all characters in point size N while retaining all prescribed spacings and motions, to 
reduce phototypesetter elapsed time. | 

-t Directs output to the standard output instead of the phototypesetter. 

—w Waits until phototypesetter is available, if currently busy. 

/tmp/ta* temporary file 

/usr/lib/tmac/tmac.* standard macro files 

/usr/lib/term/* terminal driving tables for nroff 

/usr/lib/font/* font width tables for troff 

/dev/cat phototypesetter 
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/usr/adm/tracct — accounting statistics for /dev/cat 


SEE ALSO . 

J. F. Ossanna, Nroff!Troff user’ s manual 

B. W. Kernighan, A TROFF Tutorial 
eqn(1), tbi(1), ms(7), me(7), man(7), col(1) 
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NAME 
true, false — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
True and false test for the appropriate status "true" or "false" before running (or not running) a list of com- 
mands. They are usually used in a Bourne shell script. 


EXAMPLE 
while true 
do 
command list 
done 
SEE ALSO 
csh(1), sh(1), false(1) 
DIAGNOSTICS 
True has exit status zero. 
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NAME 
tset — terminal dependent initialization 
SYNOPSIS 
tset [ options ] [ —m [ ident ] [ test baudrate ] :type } ... [ type] 


reset [ options ] [ —m [ ident ] [ test baudrate ] :type ] ... [ type ] 


DESCRIPTION 

Tset sets up your terminal when you first log in to a UNIX system. It does terminal dependent processing 
such as setting erase and kill characters, setting or resetting delays, sending any sequences needed to prop- 
erly initialized the terminal, and the like. It first determines the type of terminal involved, and then does 
necessary initializations and mode settings. The type of terminal attached to each UNIX port is specified in 
the /etc/ttys (5) database. Type names for terminals may be found in the termcap (5) database. If a port is 
not wired permanently to a specific terminal (not hardwired) it will be given an appropriate generic 
identifier such as dialup. In the case where no arguments are specified, tset sei reads the terminal type 
out of the environment variable TERM and re-initializes the terminal. 


The rest of this manual concerns itself with mode and environment initialization, typically done once at 
login, and options used at initialization time to determine the terminal type and set up terminal modes. 


When used in a startup script (.profile for sh(1) users or .Jogin for csh(1) users) it is desirable to give infor- 
mation about the type of terminal you will usually use on ports which are not hardwired. These ports are 
identified in /etc/ttys as dialup or plugboard or arpanet, etc. To specify what terminal type you usually use 
on these ports, the —m (map) option flag is followed by the appropriate port type identifier, an optional 
baud rate specification, and the terminal type. (The effect is to ‘‘map’’ from some conditions to a terminal 
type, that is, to tell tset ‘‘If I’m on this kind of port, guess that I’m on that kind of terminal’’.) If more than 
one mapping is specified, the first applicable mapping prevails. A missing port type identifier matches all 
identifiers. Any of the alternate generic names given in termcap may be used for the identifier. 


A baudrate is specified as with stty(1), and is compared with the speed of the diagnostic output (which 
should be the control terminal). The baud rate test may be any combination of: >, @, <, and !; @ means 
‘at’? and ! inverts the sense of the test. To avoid problems with metacharacters, it is best to place the 
entire argument to —m within ‘‘”’’ characters; users of csh(1) must also put a ‘‘\’’ before any ‘‘!’’ used 
here. 


Thus 
tset -m ‘dialup>300:adm3a’ -m dialup:dw2 -m ‘plugboard:?adm3a‘ 


causes the terminal type to be set to an adm3a if the port in use is a dialup at a speed greater than 300 baud; 
to a dw2 if the port is (otherwise) a dialup (i.e. at 300 baud or less). (NOTE: the examples given here 
appear to take up more than one line, for text processing reasons. When you type in real tset commands, 
you must enter them entirely on one line.) If the type finally determined by tset begins with a question 
mark, the user is asked if s/he really wants that type. A null response means to use that type; otherwise, 
another type can be entered which will be used instead. Thus, in the above case, the user will be queried 
on a plugboard port as to whether they are actually using an adm3a. 


If no mapping applies and a final type option, not preceded by a —m, is given on the command line then 
that type is used; otherwise the type found in the /etc/ttys database will be taken to be the terminal type. 
This should always be the case for hardwired ports. 


It is usually desirable to return the terminal type, as finally determined by tset, and information about the 
terminal’s capabilities to a shell’s environment. This can be done using the — option; using the Bourne 
shell, sh(1): 


export TERM; TERM= tset — options... 
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or using the C shell, esh(1): 
setenv TERM ‘tset - options... 
With csh it is preferable to use the following command in your .login file to initialize the TERM and 
TERMCAP environment variables at the same time. 
eval ‘tset -s options... 
It is also convenient to make an alias in your .cshrc: 
alias tset ‘eval ‘tset ~s \!**’ 
This allows the command: 
tset 2621 
to be invoked at any time to set the terminal and environment. Note to Bourne Shell users: It is not possi- 
ble to get this aliasing effect with a shell script, because shell scripts cannot set the environment of their 


parent. (If a process could set its parent’s environment, none of this nonsense would be necessary in the 
first place.) 


These commands cause tset to place the name of your terminal in the variable TERM in the environment; 
see environ(7). 


Once the terminal type is known, tset engages in terminal driver mode setting. This normally involves 
sending an initialization sequence to the terminal, setting the single character erase (and optionally the 
line-kill (full line erase)) characters, and setting special character delays. Tab and newline expansion are 
turned off during transmission of the terminal initialization sequence. 


On terminals that can backspace but not overstrike (such as a CRT), and when the erase character is the 
default erase character (‘#’ on standard systems), the erase character is changed to BACKSPACE (Control- 
H). 
OPTIONS 
- Prints on the standard output the name of the terminal finally decided upon. This is intended to be 
captured by the shell and placed in the environment variable TERM. 


—ec Sets the erase character to be the named character c on all terminals, the default being the back- 
space character on the terminal, usually “H. The character c can either be typed directly, or 
entered using the hat notation used here. 


-ic Sets the interrupt character to be the named character c, which defaults to “C. The hat notation 
can also be used for this option. 


-I Suppresses transmitting terminal initialization strings. 
—kce Sets the line kill character to be the named character c, which defaults to “X (for purely historical 


reasons). The kill characters are left alone if —k is not specified. The hat notation can also be 
used for this option. 


—m { indent ] [ test baudrate } : type 
Determines terminal type from port type identifier, baud rate, and terminal type. 


-n — On systems with the Berkeley 4BSD tty driver, specifies that the new tty driver modes should be 
initialized for this terminal. For a CRT, the CRTERASE and CRTKILL modes are set only if the 
baud rate is 1200 or greater. See tty(4) for more details. 


-Q Suppresses printing the ‘‘Erase set to’’ and ‘‘Kill set to’’ messages. 
—§ 


Prints the sequence of csh commands to initialize the environment variables TERM and 
TERMCAP based on the name of the terminal finally decided upon. 
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If tset is invoked as reset, it will set cooked and echo modes, turn off cbreak and raw modes, turn on new- 
line translation, and restore special characters to a sensible state before any terminal dependent processing 
is done. Any special character that is found to be NULL or ‘‘~1”’ is reset to its default value. All arguments 
to tset may be used with reset. 


This is most useful after a program dies leaving a terminal in a funny state. You may have to type 
**<LF>reset<LF>’’ to get it to work since <CR> may not work in this state. Often none of this will echo. 


EXAMPLES 


FILES 


These examples all assume the Bourne shell and use the - option. If you use csh, use one of the variations 
described above. Note that a typical use of tset in a .profile or login will also use the —e and —k options, 
and often the —n or —Q options as well. These options have not been included here to keep the examples 
small. (NOTE: some of the examples given here appear to take up more than one line, for text processing 
reasons. When you type in real tset commands, you must enter them entirely on one line.) 


At the moment, you are on a 2621. This is suitable for typing by hand but not for a .profile, unless you are 
always on a 2621. 


export TERM; TERM=“tset — 2621° 


You have an h19 at home which you dial up on, but your office terminal is hardwired and known in 
/etc/ttys. 


export TERM; TERM= tset — —m dialup:h19 


You have a switch which connects everything to everything, making it nearly impossible to key on what 
port you are coming in on. You use a vt100 in your office at 9600 baud, and dial up to switch ports at 1200 
baud from home on a 2621. Sometimes you use someone elses terminal at work, so you want it to ask you 
to make sure what terminal type you have at high speeds, but at 1200 baud you are always on a 2621. Note 
the placement of the question mark, and the quotes to protect the greater than and question mark from 
interpretation by the shell. 


export TERM; TERM= tset — —m ’switch>1200:?vt100’ —m ’switch<=1200:2621’ 


All of the above entries will fall back on the terminal type specified in /etc/ttys if none of the conditions 
hold. The following entry is appropriate if you always dial up, always at the same baud rate, on many dif- 
ferent kinds of terminals. Your most common terminal is an adm3a. It always asks you what kind of ter- 
minal you are on, defaulting to adm3a. 


export TERM; TERM=‘tset — ?adm3a° 


If the file /etc/ttys is not properly installed and you want to key entirely on the baud rate, you can use the 
following: 


export TERM; TERM= tset — —m ’>1200:vt100’ 2621° 


Here is a fancy example to illustrate the power of tset and to hopelessly confuse anyone who has made it 
this far. You dial up at 1200 baud or less on a concept100, sometimes over switch ports and sometimes 
over regular dialups. You use various terminals at speeds higher than 1200 over switch ports, most often 
the terminal in your office, which is a vt100. However, sometimes you log in from the university you used 
to go to, over the ARPANET; in this case you are on an ALTO emulating a dm2500. You also often log in 
on various hardwired ports, such as the console, all of which are properly entered in /etc/ttys. You want 
your erase character set to control H, your kill character set to control U, and don’t want tset to print the 
**Erase set to Backspace, Kill set to Control U’’ message. 


export TERM; TERM="tset -e -k°U -Q — -m_ ’switch<=1200:concept100’ -—-m 
*switch:?vt100’ —m dialup:concept100 —m arpanet:dm2500° 


/etc/ttys port name to terminal type mapping database 
/etc/termcap _ terminal capability database 
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SEE ALSO 


esh(1), sh(1), stty(1), ttys(5), termcap(5), environ(7) 
BUGS 


The tset command is one of the first commands a user must master when getting started on a UNIX system. 
Unfortunately, it is one of the most complex, largely because of the extra effort the user must go through to 
get the environment of the login shell set. Something needs to be done to make all this simpler, either the 


login(1) program should do this stuff, or a default shell alias should be made, or a way to set the environ- 
ment of the parent should exist. 


This program can’t intuit personal choices for erase, interrupt and line kill characters, so it leaves these set 
to the local system standards. 
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NAME 
tsort — topological sort 

SYNOPSIS 
tsort [ file ] 

DESCRIPTION 
Tsort produces a completely ordered list of items consistent with the partial ordering of items listed in the 
input file. Tsort prints this list on the standard output. If you do not specify a file, tsort reads the standard 
input as an input file. 


The input should consist of pairs of items (non-empty strings) separated by blanks. Pairs of different items 
indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 
lorder(1) 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 


BUGS 
Tsort uses a quadratic algorithm. This bug is not worth fixing for the typical use of ordering a library 
archive file. 
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NAME 
tty — get terminal name 
SYNOPSIS 
tty [ option ] 
DESCRIPTION 
Tty prints the pathname of the user’s terminal unless the —s (silent) is given. In either case, the exit value is 
0 if the standard input is a terminal and 1 if it is not. 
OPTIONS 
—s Suppresses the printing of the pathname ("silent" mode, no output). 
DIAGNOSTICS 
The message ‘not a tty’ means the standard input file is not a terminal. 
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NAME . 
ul — do underlining 
SYNOPSIS 

ul [ options ] [ name... ] 


DESCRIPTION | 
Ul reads the named files (or standard input if none are given) and translates occurrences of underscores to 
the sequence which indicates underlining for the terminal in use, as specified by the environment variable 
TERM. . 


UI reads the file /etc/termcap to determine the appropriate sequences for underlining. If the terminal is 
incapable of underlining, but is capable of a standout mode then that is used instead. If the terminal can 
overstrike, or handles underlining automatically, ul degenerates to cat(1). If the terminal cannot underline, 


underlining is ignored. 
OPTIONS 
~i Causes ul to indicate underlining by a separate line containing appropriate dashes ‘—’. Use this 
option when you want to look at the underlining which is present in an nroff output stream on a 
crt-terminal. 
—tterminal 


Overrides the terminal kind specified in the environment and specifies the terminal type terminal. 


SEE ALSO 
man(1), nroff(1), colert(1) 


BUGS 
Nroff usually outputs a series of backspaces and underlines intermixed with the text to indicate 
underlining. No attempt is made to optimize the backward motion. 
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NAME 
unifdef — remove ifdef ed lines 
SYNOPSIS 
unifdef [ options | [ file ] 
DESCRIPTION 
Unifdef is useful for removing ifdef’ed lines from a file while otherwise leaving the file alone. Unifdef is 
like a stripped-down C preprocessor: it is smart enough to deal with the nested ifdefs, comments, single 
and double quotes of C syntax so that it can do its job, but it doesn’t do any including or interpretation of 
macros. Neither does it strip out comments, though it recognizes and ignores them. You specify which 
symbols you want defined —Dsym or undefined —Usym and the lines inside those ifdefs will be copied to 
the output or removed as appropriate. The ifdef, ifndef, else, and endif lines associated with sym will also 
be removed. Ifdefs involving symbols you don’t specify are untouched and copied out along with their 
associated ifdef, else, and endif lines. If an ifdef X occurs nested inside another ifdef X, then the inside 
ifdef is treated as if it were an unrecognized symbol. If the same symbol appears in more than one argu- 
ment, only the first occurrence is significant. 
If you use ifdefs to delimit non-C lines, such as comments or code which is under construction, then you 
must tell unifdef which symbols are used for that purpose so that it won’t try to parse for quotes and com- 
ments in those ifdef’ed lines. You specify that you want the lines inside certain ifdefs to be ignored but 
copied out with —idsym and —iusym similar to -Dsym and —Usym above. 
Unifdef copies its output to stdout and will take its input from stdin if no file argument is given. 
OPTIONS | 
Cc Complements the operation of unifdef— that is, unifdef retains the lines that would have been 
removed or blanked and removes the lines that would have been saved. 
—Dsym Specifies which symbols you want defined. Lines within those ifdefs you want copied or 
removed. 
—idsym Defines the lines within ifdefs you want ignored and copied out. 
-iusym Tells unifdef what lines you want undefined. See idsym. 
-| Causes unifdef to replace removed lines with blank lines instead of deleting them. 
—t Lets you use unifdef for plain text rather than C code. With the —t option, unifdef does not try 
to recognize comments and single and double quotes. 
—Usym Specifies which symbols you want undefined. See —Dsym. 
SEE ALSO 
diff(1) 
DIAGNOSTICS 
Premature EOF, inappropriate else or endif. 
Exit status is 0 if output is exact copy of input, 1 if not, 2 if trouble. 
BUGS 


Unifdef does not know how to deal with cpp consructs such as 
#if defined(X) || defined(Y) 
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NAME 
unig — report repeated lines in a file 


SYNOPSIS | 
unig [ options ] [ input [ output]}] - 


DESCRIPTION 
Unig reads the input file comparing adjacent lines. In the normal case, the second and succeeding copies 
of repeated lines are removed; the remainder is written on the output file. Note that repeated lines must be 
adjacent in order to be found; see sort(1). | 


OPTIONS | 
The m arguments specify skipping an initial portion of each line in the comparison: 


—n The first n fields together with any blanks before each are ignored. A field is defined as a string 
of non-space, non-tab characters separated by tabs and spaces from its neighbors. 


+n The first x characters are ignored. Fields are skipped before characters. 
Other options include: 


—c Supersedes —u and —d. Generates an output report in default style but with each line preceded by 
a count of the number of times it occurred. 


-d Prints one copy of the repeated lines only. 


—u Outputs only the lines that are not repeated in the original file. (By default, uniq outputs one 
occurrence of the repeated lines.) 


The normal mode output is the union of the —u and —d mode outputs. 


SEE ALSO 
sort(1), comm(1) 
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NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 


BUGS 


Units converts quantities expressed in various standard scales to their equivalents in other scales. It works 
interactively in this fashion: 
You have: inch 
You want: cm 
+ 2.54000e +00 
! 3.9370le—01 


A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, division by the usual sign: 


You have: 15 pounds force/in2 
You want: atm 

* 1.02069e +00 

! 9.79730e~-01 


Units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not Centigrade to 
Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a gen- 
erous leavening of exotica and a few constants of nature including: 


au astronomical unit 

c speed of light 

e charge on an electron 
g acceleration of gravity 


force same as g 

mole Avogadro’s number 

pi ratio of circumference to diameter 
water pressure head per unit height of water 


‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘lightyear’. British units that differ from 
their US counterparts are prefixed thus: ‘brgallon’. Units denotes currency ‘belgiumfranc’, ‘britainpound’, 
and so forth. 


For a complete list of units, type the shell command 
cat /usr/lib/units — 


/usr/lib/units 


Don’t base your financial plans on the currency conversions. 
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NAME 

uptime — show how long system has been up 
SYNOPSIS | 

uptime 


DESCRIPTION 
Uptime prints the current time, the length of time the system has been up, and the average number of jobs 
in the run queue over the last 1, 5 and 15 minutes. It is, essentially, the first line of a w(1) command. 


FILES 
/ymunix system name list 


SEE ALSO 
w(1) 
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NAME 
users — compact list of users who are on the system 
SYNOPSIS 
users 
DESCRIPTION 
Users lists the login names of the users currently on the system in a compact, one-line format. 
FILES 
/etc/utmp 


SEE ALSO 
who(1) 
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uucp — unix to unix copy 


SYNOPSIS 


uucp [ options ] source ee: destination- nie 


DESCRIPTION 


Uuep copies files named by the source-file arguments to the destination-file pia A filename may be 
a pathname on your machine, or may have the form 


system name!pathname 


where system name is taken from a list of system names that uucp knows about. Shell metacharacters 
?*{(] appearing in the pathname part will be expanded on the appropriate system. 


Pathnames may be one of: 


(1) a full pathname; | 
(2) a pathname preceded by “user; where user is a userid on the specified system and is replaced 
by that user’s login directory; 

(3) a pathname prefixed by ~, where ~ is expanded into the system’s public directory (usually 
/usr/spool/uucppublic); 


(4) a partial pathname, which is prefixed by the current directory. 


If the result is an erroneous pathname for the remote system, the copy will fail. If the destination-file is a 
directory, the last part of the source-filename is used. 


Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions 


(see chmod (2)). 
OPTIONS 
—a Avoids doing a getwd to find the current directory. (This is sometimes used for efficiency.) 
—C Uses the source file when copying out rather than copying the file to the spool directory. (This 
is the default.) 
-C Copies the source file to the spool directory and transmit the copy. 
~—d Makes all necessary directories for the file copy. (This is the default.) 
—f Does not make intermediate directories for the file copy. 
-g grade Grade is a single letter/number; lower ASCII sequence characters will cause a job to be 
transmitted earlier during a particular conversation. Default is ‘n’. By way of comparison, 
uux(1C) defaults to ‘A’; mail is usually sent at ‘C’. 
—m Sends mail to the requester when the copy is complete. 
—nuser _— Notifies user on remote system (i.e., send user mail) that a file was sent. 
—r Does not start the transfer, just queue the job. 
~s spool Uses spool as the spool directory instead of the default. 
. ~-x debug Turns on the debugging at level debug. 
FILES 
/usr/spool/uucp - spool directory 
/usr/lib/uucp/* - ~ other data and program files 
SEE ALSO . 


uux(1C), maill(1) 
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D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Systems. 
D. A. Nowitz, Uucp Implementation Description. 


WARNING 


BUGS 


The domain of remotely accessible files can (and for obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files by pathname; ask a responsible person on the 
remote system to send them to you. For the same reasons you will probably not be able to send files to 
arbitrary pathnames. 


All files received by uucp will be owned by the uucp administrator (usually UID 5). 


The —m option will only work sending files or receiving a single file. (Receiving multiple files specified by 
special shell characters ?*[] will not activate the —m option.) 


At present uucp cannot copy to a system several "hops" away, that is, a command of the form 
uucp myfile system] !system2!system3!yourfile 
is not permitted. Use uusend(1C) instead. 
When invoking uucp from csh(1), the ‘!’ character must be prefixed by the ‘\’ escape to inhibit csh’s his- 
tory mechanism. (Quotes are not sufficient.) 


Uucp refuses to copy a file that does not give read access to ‘‘other’’; that is, the file must have at least 
0444 modes. 
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NAME 


uuencode, uudecode — encode/decode a binary file for transmission via mail 


SYNOPSIS 


uuencode [ sourcefile ] remotedest| mail sys] /sys2/../user 
uudecode [ file ] . 


DESCRIPTION 


Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combination can be 
used over indirect mail links even when uusend(1C) is not available. 


Uuencode takes the named sourcefile (default standard input) and produces an encoded version on the 
standard output. The encoding uses only printing ASCII characters, and includes the mode of the file and 
the remotedest for recreation on the remote system. 


Uudecode reads an encoded file, strips off any leading and trailing lines added by mailers, and recreates 
the original file with the specified mode and name. 


Uuencodes intends that all mail to the specified user should be filtered through the uudecode program. 
This way the file is created automatically without human intervention. This is possible on the uucp net- 
work by either using sendmail or by making rmail be a link to Mail instead of mail. In each case, an alias 
must be created in a master file to get the automatic invocation of uudecode. 


If these facilities are not available, the file can be sent to a user on the remote machine who can uudecode it 
manually. . 


The encode file has an ordinary text form and can be edited by any text editor to change the mode or 
remote name. 


_ SEE ALSO 


BUGS 


atob(n), uusend(1C), uucp(1C), uux(1C), mail(1), uuencode(5) 


The file is expanded by 35% (3 bytes become 4 plus control information) causing it to take longer to 
transmit. 


The user on the remote system who is invoking diidetnde (often uucp) must have write permission on the 
specified file. : 
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NAME 
uulog — display UUCP log files 


SYNOPSIS 

uulog [ options } 
DESCRIPTION 

Uulog queries a log of uucp(1C) and uux(1C) transactions in the file /usr/spool/uucp/LOGFILE. 
OPTIONS 

The options command uulog to print logging information: 

—s sys _ Prints information about work involving system sys. 

—uuser Prints information about work done for the specified user. 


FILES 
/ust/spool/uucp/LOGFILE ro 


SEE ALSO 
uucp(1C), uux(1C). 


NOTES 
Very early releases of UUCP used separate log files for each of the UUCP utilities: uulog was used to merge 
the individual logs into a master file. This capability has not been necessary for some time and is no longer 
supported. 


BUGS 
UUCP’s recording of which user issued a request is unreliable. 


Uulog is little more than an overspecialized version of grep(1). 
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NAME | 
uuname — list names of UUCP hosts 


SYNOPSIS 
uuname [ option } 
DESCRIPTION 
‘Uuname lists the UUCP names of known systems. 


OPTIONS 
-] Returns the local system name. This may differ from the hostname(1) of the system if the host- 
name is very long. 


SEE ALSO 
uucp(1C), uux(1C). 
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NAME 
uuq — examine or manipulate the uucp queue 
SYNOPSIS 
uugq [ options ] 
DESCRIPTION 
Uugq is used to examine (and possibly delete) entries in the uucp queue. 
When listing jobs, uuq uses a format reminiscent of Is. For the long format, information for each job listed 
includes 
e job number 
e number of files to transfer 
e user who spooled the job 
e number of bytes to send 
e type of command requested (S for sending files, R for receiving files, X for remote uucp) 
e file or command desired. 
OPTIONS 
—bbaud —_Uses baud to compute the transfer time instead of the default 1200 baud. 
—djobno _ Deletes job number jobno (as obtained from a previous uug command) from the uucp queue. 
Only the UUCP Administrator is permitted to delete jobs. 
—h Prints only the summary lines for each system. Summary lines list system name, number of 
jobs for the system, and total number of bytes to send. 
-l1 Specifies a long format listing. The default is to list only the job numbers sorted across the 
page. 
—rsdir Looks for files in the spooling directory sdir instead of the default directory. 
—ssystem Limits output to jobs for systems whose system names begin with system. 
—uuser Limits output to jobs for users whose login names begin with user. 
FILES 
/ustr/spool/uucp/ . Default spool directory 
/usr/spool/uucp/C./C.* Control files 
/usr/spoolV/uucp/Dhostname./D.* Outgoing data files 
/usr/spool/uucp/X/X.* Outgoing execution files 
SEE ALSO 
uucp(1C), uux(1C), uulog(1C), uusnap(8C) 
BUGS 


No information is available on work requested by the remote machine. 
The user who requests a remote uucp command is unknown. 
Uugq —1 can be horrendously slow. 
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NAME 
uusend — send a file to a remote host 


_ SYNOPSIS | 
uusend [ option } sourcefile sys] !sys2!..!remotefile 


DESCRIPTION | 
Uusend sends a file to a given location on a remote system. The system need not be directly connected to 
the local system, but a chain of uucp(1) links needs to connect the two systems. 


If you specify the sourcefile as ‘‘—’’, uusend treats the standard input as the sourcefile. This flag and the 
~m flag described below are intended primarily for internal use of uusend. 


The remotefile can include the “userid syntax. 


OPTION 
—m mode 
Takes the mode of the file on the remote end from the given octal number. Otherwise, uusend 
uses the mode of the input file. 


DIAGNOSTICS 
If anything goes wrong any further away than the first system down the line, you will never hear about it. 


SEE ALSO 
uux(1), uucp(1), uuencode(1) 


BUGS 
Uuep should make this command unnecessary. 


All systems along the line must have the uusend command available and allow remote execution of it. 


Some uucp systems have a bug that disallows binary files as input to a uux command. If this bug exists in 
any system along the line, the file will show up severly munged. 
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NAME 
uux — unix tO unix command execution 
SYNOPSIS 
uux [ options ] command-string 
DESCRIPTION 
Uux will gather zero or more files from various systems, execute a command on a specified system and 
then send standard output to a file on a specified system. 
The command-string is made up of one or more arguments that look like a Shell command line, except that 
the command and filenames may be prefixed by system name !. A null system name is interpreted as the 
local system. 
File names may be one of 
(1) a full path name; 
(2) a path name preceded by “user where user is a login name on the specified system and is 
replaced by that user’s login directory; 
(3) a path name prefixed by ~; where ~ is expanded to the system’s public directory (usually 
/usr/spool/uucppublic); 
(4) a partial pathname, which is prefixed by the current directory. 
As an example, the command | | 
uux " !diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !"/dan/file.diff" 
gets the filel and file2 files from the ‘‘usg’’ and ‘‘pwba’’ machines, executes a diff(1) command and puts 
the results in file.diff in the local /usr/spool/uucppublic/dan/ directory. 
Any special shell characters, such as <>;|, should be quoted either by quoting the entire command-string, 
or quoting the special characters as individual arguments. 
Uux will attempt to get all files to the execution system. For files that are output files, the filename must be 
escaped using parentheses. For example, the command 
uux a!we b!/usr/filel \(c!/usr/file2 \) 
gets /usr/filel from system ‘‘b’’ and send it to system ‘‘a’’, runs we command on that file and sends the 
result of the wc command to system ‘‘c’’. 
Uux will notify you by mail if the requested command on the remote system was disallowed. This 
notification can be turned off by the —n option. 
OPTIONS 


- Makes the standard input to uux the standard input to the command-string. 
~aname _ Uses name as the user identification replacing the initiator user-id. 


—C Does not copy local file to the spool directory for transfer to the remote machine (this is the 
default). 
-C Forces the copy of local files to the spool directory for transfer. 


~gegrade Sets the grade for the uux operation. Grade is a single letter/number, from 0 to 9, A to Z, or a 
to z; 0 is the highest, and z is the lowest grade. The default is A; by comparison uucp(1C) 
defaults to n and mail is usually sent at grade C. Lower grades should be specified for high- 
volume jobs, such as news. 


-1 Tries to make a link from the original file to the spool directory. If the link cannot be made, 
uux copies the file. . 
-L Starts up uucico with the -L flag. This will force calls to be made to local sites only (see 
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uucico(8C)). 
—n Does not notify the user when the command completes. 
-—p Same as -: Makes the standard input to uux the standard input to the commana-string. 
-r Does not start the file transfer, just queue the job. 


~xdebug Produces debugging output on stdout. The debug is a number between 0 and 9; higher 
numbers give more detailed information. Debugging is permitted only for Pavieees users 
(specifically, those with read access to L.sys(5). 


2 Notifies the user only if the command fails. 
FILES 
/ust/spool/uucp spool directories 
/usr/lib/uucp/* UUC?P configuration data and daemons 
SEE ALSO 


uucp(1C), uucico(8C), uuxqt(8C). 


WARNING 


BUGS 


For security reasons, many installations will limit the list of commands executable on behalf of an incom- 
ing request from uux. Many sites will permit little more than the receipt of mail (see mail{1)) via uux. 


Only the first command of a shell pipeline may have a system-name!. All other commands are executed on 
the system of the first command. 


The use of the shell metacharacter * will probably not do what you want it to do. 
The shell tokens << and >> are not implemented. 


When invoking uux from csh(1), the ‘!’ character must be prefixed by the ‘\’ escape to inhibit csh’s history 
mechanism. (Quotes are not sufficient.) 
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NAME 
vacation — return ‘‘I am on vacation’’ message 
SYNOPSIS 
vacation [ option ] 
vacation user 
DESCRIPTION 
Vacation returns a message saying that you are on vacation to any user who sends you mail. It is intended 
for use in a forward file. For example, your .forward file might contain the following: 
\eric, "|vacation eric” 
This line would send messages to you (assuming your login name was eric) and send a message back to the 
sender. 
Vacation expects a file called .vacation.msg in your home directory containing a message to be sent back 
to each sender. It should be an entire message (including headers). For example, it might say: 
From: eric@ucbmonet.Berkeley.EDU (Eric Allman) 


Subject: I am on vacation 
Delivered-By-The-Graces-Of: the Vacation program 


I am on vacation until July 22. If you have something urgent, 
please contact Joe Kalash <kalash@ucbingres Berkeley. EDU>. 
--eric 
Vacation will send this message only once a week to each unique sender. A list of the people who have 
sent you messages are kept in the files .vacation.pag and .vacation.dir in your home directory. The —I 
option initializes these files. You should run vacation with this option before before you modify your -for- 
ward file. 


If the —I flag is not specified, vacation reads the first line from the standard input for a UNIX-style “‘From’’ 
line to determine the sender. If this is not present, a nasty diagnostic is produced. Sendmail(8) includes 
the ‘‘From’’ line automatically. . 


No message is sent if the initial ‘‘From’’ line includes the string ‘‘-REQUEST@”’ or if a ‘“Precedence: 
bulk’’ or ‘Precedence: junk’’ line is included in the header. 


OPTION 
-I Initializes the files .vacation.pag and .vacation.dir. Run vacation with this option before you 
modify your .forward file. 
SEE ALSO 
sendmail(8) 
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NAME 


vgrind — grind nice listings of programs | 


SYNOPSIS 


vgrind [ options ] name ... 


DESCRIPTION 


Vgrind formats the program sources which are arguments in a nice style using troff(1). Vgrind puts in 
italics, keywords in bold face, and lists the name of the current function down the margin of each page as 
the name is encountered. 


Vgrind runs in two basic modes, filter mode or regular mode. In filter mode vgrind acts as a filter in a 


manner similar to tbl(1). The standard input is eae directly to the standard output except for lines 


bracketed by the troff-like macros: 
.vS - Starts processing 


VE -- ends processing 


These lines are formatted as described above. The output from this filter can be passed to troff for output. 
There need be no particular ordering with eqn(1) or tbi(1). 


In regular mode vgrind accepts input files, processes them, and passes them to troff(1) for output. 
In both modes vgrind passes any lines beginning with a decimal point without conversion. 


OPTIONS | 


FILES 


- Forces input to be taken from standard input (default if 
—d file Specifies an alternate language definitions file ccetault is /usr/lib/vgrindefs). —f is specified ). 
-f Forces filter mode. 


| ~h header Specifies a particular header to put on every output page (default is the filename). 


—language Specifies the language to use. Currently known are PASCAL (—Ip), MODEL (—Im),C (—Ic or 
the default), CSH (—Icsh), SHELL (—Ish), RATFOR (—Ir), MODULA2 (—Imod2), YACC 
(-lyacc), ISP (—lisp), and ICON (—I). 


—n Forces no keyword bolding. 

—Ssn Specifies a point size 1 to use on output (exactly the same as the argument of a ._ps command). 
—t Similar to the same option in troff causing formatted text to go to the standard output. 

—-W Forces output to the (wide) Versatec printer rather than the (narrow) Varian. 


~-x Outputs the index file in a **pretty’’ format. The index file itself is produced whenever vgrind 
is run with a file called index in the current directory. The index of function definitions can 
then be run off by giving vgrind the —x option and the file index as argument. 


index file where source for index is created 


_ /usr/lib/tmac/tmac.vgrind macro package 


/usr/lib/vfontedpr preprocessor 
/usr/lib/vgrindefs language descriptions 


SEE ALSO 


BUGS 


vip(1), vtroff(1), vgrindefs(5) 


Vfontedpr assumes that a certain programming style is followed: 
For C — function names can be preceded on a line only by spaces, tabs, or an asterisk. The parenthesized — 


arguments must also be on the same line. 
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For PASCAL -— function names need to appear on the same line as the keywords function or procedure. 
For MODEL - function names need to appear on the same line as the keywords is beginproc. 


If these conventions are not followed, the indexing and marginal function name comment mechanisms will 
fail. 


More generally, arbitrary formatting styles for programs mostly look bad. The use of spaces to align 
source code fails miserably; if you plan to vgrind your program you should use tabs. This is somewhat 
inevitable since the font used by vgrind is variable width. 


The mechanism of ctags in recognizing functions should be used here. 
Filter mode does not work in documents using the —me or —ms macros. 


May 5, 1986 INTEGRATED SOLUTIONS 4.3 BSD 2 


VI(1) | UNIX Programmer’s Manual | VI(1) 


NAME 

vi — screen oriented (visual) display editor based on ex 
SYNOPSIS 

vi [ options } [ files ] 


DESCRIPTION 
Vi (visual) is a display oriented text editor based on ex(1). Ex and vi run the same code. The user can 
access the command mode of ex from within vi and vice-versa. 


The Vi Quick Reference card and the Introduction to Display Editing with Vi provide full details on using 


vi. 
OPTIONS 
+Pos Positions the file at pos (end of the file default). Pos is any editor command which does not 
contain a space. 
-l Sets options appropriately for editing LISP. 
rr Retrieves last saved version of file after a system or editor crash. (List of all saved files is the 
default.) 
-t tag Edits file containing tag and positions editor at its definition. 
—wn Sets default window size to n. 
_ FILES 
See ex(1). 
SEE ALSO 


ex(1), edit(1), 
Vi Quick Referencecard, An Introduction to Display Editing with Vi. 


BUGS 
Software tabs using “T work only immediately after the autoindent. 


Left and right shifts on intelligent terminals don’t make use of insert and delete character operations in the 
terminal. 

The wrapmargin option can be fooled since it looks at output columns when blanks are typed. If a long 
word passes through the margin and onto the next line without a break, then the line won’t be broken. 


Insert/delete within a line can be slow if tabs are present on meter terminals, since the terminals need 
help in doing this correctly. 


Saving text on deletes in the named buffers is somewhat inefficient. 


The source command does not work when executed as :source; there is no way to use the :append, 
:change, and :insert commands, since it is not possible to give more than one line of input to a : escape. 
To use these on a :global you must Q to ex command mode, execute them, and then reenter the screen edi- 
tor with vi or open. 
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NAME 


vip — Format Lisp programs to be printed with nroff, vtroff, or troff 


SYNOPSIS 


vip [ options } files 


DESCRIPTION 


OPTIONS 


FILES 


Vip formats the named files so that they can be run through nroff, vtroff, or troff to produce listings that 
line-up and are attractive. The first non-blank character of each line is lined-up vertically, as in the source 
file. Comments (text beginning with a semicolon) are printed in italics. Each function’s name is printed in 
bold face next to the function. This format makes Lisp code look attractive when it is printed with a vari- 
able width font. 


Normally, vip works as a filter and sends its output to the standard output. However, the —v switch pipes 
the output directly to vtroff. If no files are specified, then vlp reads from the standard input. 


—d Puts vip into debugging mode. 


-f Formats Lisp code embedded in a document. This is Vip’s filtered mode, in which all lines are 
passed unmodified, except those lines between the directives .Ls and .Le. The directive .Ls takes 
an optional argument that gives the point size for the embedded code. If not size is specified, the 
size of the surrounding text is used. 


-l Prevents vip from placing labels next to functions. This switch is useful for embedded Lisp code, 
where the labels would be distracting. 


—p pointsize 
Changes the size of the text from its default value of 8 points to the specified size of 6, 8, 10, or 12 
points. Once set, the point size is used for all subsequent files. This point size does not apply to 
embedded text (see —f above). 


-T title Specifies a title to be printed on each page. Each —T switch applies only to the next filename 
given. If you want to specify titles for more than one file, include the -T option and a title before 
each filename on the command line. Titles are not printed for embedded text (see —f, above). This 
Switch may not be used if vip is reading from the standard input. 


-Vv Causes vlp to send its output to vtroff rather than the standard output. 


/usr/lib/vipmacs troff/nroff macros 


SEE ALSO 


BUGS 


vgrind(1), lisp(1) 


Vip transforms \ into \\ so that it will be printed out. Hence, troff commands cannot be embedded in Lisp 
code. 
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NAME 
vmstat — report virtual memory statistics 
SYNOPSIS 
vmstat [ options } [ drives ] [ iibival [ count } J 


DESCRIPTION 
Vmstat delves into the system and normally Tne certain statistics kept about process, virtual memory, 
disk, trap and cpu activity. 


If none of these options are given, vmstat will report in the first line a summary of the virtual memory 
activity since the system has been booted. If interval is specified, then successive lines are summaries over 
the last interval seconds. The command 


vmstat § 


prints what the system is doing every five seconds. Five seconds is a good choice of printing interval since 
this is how often some of the statistics are sampled in the system. Others vary every second, running the 
output for a while will make it apparent which are recomputed every second. If a count is given, the statis- 
tics are repeated count times. 


If more than four disk drives are configured in the system, vmstat displays only the first four drives, with 
priority given to Massbus disk drives (i.e. if both Unibus and Massbus drives are present and the total 
number of drives exceeds four, then some number of Unibus drives will not be displayed in favor of the 
Massbus drives). To force vmstat to display specific drives, their names may be supplied on the command 
line. 


‘OPTIONS 
_f Instead of reporting its standard statistics, reports on the number of forks and vforks since system 
startup and the number of pages of virtual memory involved in each kind of fork. 


—i Instead of reporting its standard statistics, reports on the number of interrupts taken by each dev- 
ice since system startup. 


Ss Instead of reporting its standard statistics, prints the contents of the sum structure, giving the total 
number of several kinds of paging related events which have occurred since boot. 


FORMAT FIELDS 
Procs: information about numbers of processes in various States. 


r - in run queue 
b blocked for resources (i/o, paging, etc. 7 
Ww runnable or short sleeper (< 20 secs) but swapped 


Memory: information about the usage of virtual and real memory. Virtual pages are considered active if 
they belong to processes which are running or have run in the last 20 seconds. A ‘“‘page’’ here is 1024 


bytes. 

avm active virtual pages 

fre size of the free list | 
Page: information about page faults and paging activity. These are averaged each five seconds, and given 
in units per second. 

re page reclaims (simulating reference bits) 

at pages attached (found in free list) 

pi pages paged in 

po pages paged out 

fr pages freed per second 

de anticipated short term memory shortfall 

sr pages scanned by clock algorithm, per-second 
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up/hp/rk/ra: Disk operations per second (this field is system dependent). Typically paging will be split 
across several of the available drives. The number under each of these is the unit number. 


Faults: trap/interrupt rate averages per second over last 5 seconds. 


in (non clock) device interrupts per second 
sy system calls per second 
cs Cpu context switch rate (switches/sec) 


Cpu: breakdown of percentage usage of CPU time 


us user time for normal and low priority processes 
sy system time 
id cpu idle 
FILES 
/dev/kmem, /vmunix i. 
SEE ALSO 


systat(1), iostat(1) . 
The sections starting with ‘‘Interpreting system activity’ in Installing and Operating 4.2bsd. 
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NAME 
vwidth — make troff width table for a font 

SYNOPSIS , 7 
vwidth fontfile pointsize > ftxx.c 
ce -c ftxx.c 

. Mv ftcxx.o /usr/lib/font/ftxx 

DESCRIPTION 
Vwidth translates width information stored in the vfont style format to the object file format expected by 
troff. Troff wants an object file in a.out(5) format. (This fact does not seem to be documented anywhere.) 
Troff should look directly in the font file but it doesn’t. 
Use vwidth after editing a font with fed(1). You don’t need to use vwidth unless you have made a change 
that would affect the width tables. Such changes include numerically editing the width field, adding a new 
character, and moving or copying a character to a new position. It is not always necessary to use vwidth if 
the physical width of the glyph (e.g. the number of columns in the bit matrix) has changed; however, if the 
physcial width has changed much the logical width should probably be changed as well and vwidth should 
be run. 
Vwidth produces a C program on its standard output. Run this program through the C compiler and save 
the object file (that is, the resulting .o file). Place the object file in /usr/lib/font in the file ftcx where is a one 
or two letter code that is the logical (internal to troff) font name. This name can be found by looking in the 
file /usr/lib/fontinfo/fname* where fname is the external name of the font. 

SEE ALSO 
fed(1), troff(1), vtroff(1) vfont(5), 

BUGS 


Produces the C file using obsolete syntax that the portable C compiler complains about. 
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NAME 
w — who is on and what they are doing 


SYNOPSIS 
w({—h][-s] [user] 


DESCRIPTION 
W prints a summary of the current activity on the system, including what each user is doing. The heading 
line shows the current time of day, how long the system has been up, the number of users logged into the 
system, and the load averages. The load average numbers give the number of jobs in the run queue aver- 
aged over 1, 5, and 15 minutes. 


The fields output are: 


e the users login name 

e the name of the tty the user is on 

e the time of day the user logged on 

e the number of minutes since the user last typed anything 

e the CPU time used by all processes and their children on that terminal 
e the CPU time used by the currently active processes 

e the name and arguments of the current process. 


If a user name is included, the output will be restricted to that user. 


OPTIONS 
—-h Suppresses the heading. 


-l Prints the long output, which is the default. 


-s Asks for a short form of output. In the short form, the tty is abbreviated, the login time and cpu 
times are left off, as are the arguments to commands. 


FILES 
/etc/utmp 
/dev/kmem 
/dev/drum 


SEE ALSO 
who(1), finger(1), ps(1) 

BUGS 
The notion of the ‘‘current process’’ is muddy. The current algorithm is ‘‘the highest numbered process on 
the terminal that is not ignoring interrupts, or, if there is none, the highest numbered process on the termi- 

nal’’. This fails, for example, in critical sections of programs like the shell and editor, or when faulty pro- 

grams running in the background fork and fail to ignore interrupts. (In cases where no oe can be 
found, w prints ‘‘—’’.) 
The CPU time is only an estimate, in particular, if someone leaves a background process running after log- 
ging out, the person currently on that terminal is “‘charged’’ with the time. 


Background processes are not shown, even though they account for much of the load on the system. 


Sometimes processes, typically those in the background, are printed with null or garbaged arguments. In 
these cases, the name of the command is printed in parentheses. 


W does not know about the new conventions for detection of background jobs. It will sometimes find a 
background job instead of the right one. 
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NAME 
wait — await completion of process 
SYNOPSIS 
wait | 
DESCRIPTION ai | "4 
This command waits until all background processes (processes started with &) have completed, then 
reports on abnormal terminations. 


Because the wait(2) system call must be executed in the parent process, the Shell itself executes wait, 
without creating a new process. 


SEE ALSO 
sh(1) 


BUGS 
Not all the processes of a 3- or more-stage pipeline are children of the Shell; thus, these processes cannot 
be waited for. (This bug does not apply to csh(1).) 
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NAME 
wall — write to all users 


SYNOPSIS 
wall 


DESCRIPTION 
Wall reads its standard input until an end-of-file. It then sends the message entered on its standard input, 
preceded by “Broadcast Message ...’, to all logged in users. 


The sender should be super-user to override any protections the users may have invoked. 


FILES 
/devitty? 
/etc/utmp 


SEE ALSO 
mesg(1), write(1) 


DIAGNOSTICS 
“Cannot send to ...’ when the open on a user’s tty file fails. 
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-NAME 

we — word count 
SYNOPSIS 

we [ options } [ name ... ] 


DESCRIPTION | 
We counts lines, words and characters in the named files, or in the standard input if no filename is 
specified. A word is a maximal string of characters delimited by spaces, tabs or newlines. 


OPTIONS 
-C Counts only the number of characters. 


~1 ~ —_ Counts only the number of lines. 
-—w Counts only the number of words. 
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NAME 
what — show what versions of object modules were used to construct a file 

SYNOPSIS 
what filenames 

DESCRIPTION 
What reads each file and searches for sequences of the form ‘‘@(#)’’ as inserted by the source code con- 
trol system. It then prints the remainder of the string after this marker, up to a null character, newline, dou- 
ble quote, or ‘‘>’’ character. 

BUGS 
As SCCS is not licensed with UNIX/32V, this is a rewrite of the what command which is part of SCCS, 
and may not behave exactly the same as that command does. 
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‘NAME 
whatis — describe what a command is 


SYNOPSIS 
whatis command ... 

DESCRIPTION 
Whatis looks up a given command and prints the header line from the manual section. You can run the 
man(i) command to get more information about a particular command. If the line starts ‘name(section) ...’ 
you can type ‘man section name’ to display the documentation for it. For example, the line whatis ed 
prints the line "ed (1) - text editor", and the line man 1 ed prints the manual. 

Whatis is actually the -f option to the man(1) command. 


FILES 
/usr/man/whatis Data base 


SEE ALSO 
man(1), catman(8) 
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NAME 
whereis — locate source, binary, and or manual for program 

SYNOPSIS 
whereis [ options ] filenames 

DESCRIPTION 
Whereis locates source/binary and manuals sections for specified files. The supplied names are first 
stripped of leading pathname components and any (single) trailing extension of the form ‘‘.ext’’, e.g. ‘‘.c’’ 
Prefixes of ‘‘s.’’ resulting from use of source code control are also dealt with. Whereis then attempts to 
locate the desired program in a list of standard places. 

OPTIONS 
—b Searches only for binaries. 


~B dir Searches for binaries in the specified directory or directories. 


—f Terminates the last such directory list and signal the start of filenames. 
—-m Searches only for manual sections respectively. 

—M dir Searches for manual entries in the specified directory or directories. 
-s Searches only for sources. 


-S dir Searches for sources in the specified directory or directories. 


—u Searches for unusual entries. A file is said to be unusual if it does not have one entry of each 
requested type. Thus ‘‘whereis -m -u *’’ asks for those files in the current directory which have 
no documentation. 


EXAMPLE 
The following set of commands find all the files in /usr/bin which are not documented in /usr/man/man1 
with source in /usr/src/cmd: 


cd /usr/ucb 
whereis —u —M /usr/man/man1 —S /usr/src/cmd —f * 
_ FILES 
/usr/src/* 
/usr/{doc,man}/* 
fib, /etc, /usr/{lib,bin,ucb,old,new, local} 
BUGS 


Since the program uses chdir(2) to run faster, pathnames given with the -M —S and —B must be full; i.e. 
they must begin with a ‘‘/’’. 
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NAME 
which — locate a program file including aliases and paths (csh only) 
SYNOPSIS | 
which filenames 
DESCRIPTION 
Which takes a list of names and looks for the files which would be executed had these names ‘heed given as 
commands. Each argument is expanded if it is aliased, and searched for along the user’s path. Both aliases 
and path are taken from the user’s .cshre file. 
FILES 
“/.cshre source of aliases and path values 
DIAGNOSTICS 


A diagnostic is given for names which are aliased to more than a single word, or if an executable file with 
the argument name was not found in the path. 


BUGS 
Which must be executed by a csh, since only csh’s know about aliases. 
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NAME 
who — who is on the system 

SYNOPSIS 
who [ who-file ] [am I] 

DESCRIPTION 
Without an argument, who lists the login name, terminal name, and login time for each current UNIX user. 
It examines the /etc/utmp file to obtain its information. 
If a filename is specified on the command line, who searches that file for this login information. Typically 
the given file will be /usr/adm/wtmp, which contains a record of all the logins since it was created. Then 
who lists logins, logouts, and crashes since the creation of the wtmp file. Each login is listed with user 
name, terminal name (with ‘/dev/’ suppressed), and date and time. When an argument is given, logouts 
produce a similar line without a user name. Reboots produce a line with ‘x’ in the place of the device 
name, and a fossil time indicative of when the system went down. 
With two arguments, as in ‘who am I’ (and also ‘who are you’), who tells what user you are logged in as, 
what terminal you are using, and when you logged in. 

FILES 
/etc/utmp 

SEE ALSO 
getuid(2), utmp(5) 
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NAME 

whoami — print effective current user id 
_ SYNOPSIS 

whoami 

DESCRIPTION , 
Whoami prints your true user name. It works even if you are su’d onto another account. The who com- 
mand who am i does not work in this condition because it gets its information from /etc/utmp. 

FILES 
/etc/passwd Name data base 

SEE ALSO 


who(1) 
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NAME 
whois — DARPA Internet user name directory service 


SYNOPSIS 
whois name 
DESCRIPTION 
To use whois, enter a name or a handle (‘‘ident"), such as ‘‘Smith" or ‘‘SRI-NIC". Starting with a period 
forces a name-only search; starting with exclamation point forces handle-only. Examples: 
Smith looks for name or handle SMITH 
'SRI-NIC looks for handle SRI-NIC only 
Smith, John looks for name JOHN SMITH only 
Adding ‘‘..." to the argument will match anything from that point, e.g. ‘“ZU...” will match ZUL, ZUM, etc. 
Whois then looks for the name or handle you specified. 
To see the ENTIRE membership list of a group or organization, if you are asking about a group or org, 
shown with the record, use an asterisk character ‘*’ directly preceding the given argument. [CAUTION: If 
there are a lot of members this will take a long time!] You may of course use an exclamation point and an 
asterisk, or a period and an asterisk together. 


For a help message similar to the description above, type: 
whois help 


SEE ALSO 
RFC 812: Nicname/Whois 
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NAME 


“window — window environment 


SYNOPSIS 


window [ options ] 


DESCRIPTION 


Window implements a window environment on ASCII terminals. 


A window is a rectangular portion of the physical terminal screen associated with a set of processes. Its 
size and position can be changed by the user at any time. Processes communicate with their window in the 
same way they normally interact with a terminal--through their standard input, output, and diagnostic file 
descriptors. The window program handles the details of redirecting input an output to and from the win- 
dows. At any one time, only one window can receive input from the keyboard, but all windows can simul- 
taneously send output to the display. 


Windows can overlap and are framed as necessary. Each window is named by one of the digits ‘‘1’’ to 
**9”’, This one character identifier, as well as a user definable label string, are displayed with the window 
on the top edge of its frame. A window can be designated to be in the foreground, in which case it will 
always be on top of all normal, non-foreground windows, and can be covered only by other foreground 
windows. A window need not be completely within the edges of the terminal screen. Thus a large window 
(possibly larger than the screen) may be positioned to show only a portion of its full size. 


Each window has a cursor and a set of control functions. Most intelligent terminal operations such as line 
and character deletion and insertion are supported. Display modes such as underlining and reverse video 
are available if they are supported by the terminal. In addition, similar to terminals with multiple pages of 


‘memory, each window has a text buffer which can have more lines than the window itself. 


OPTIONS 


When window starts up, the commands (see long commands below) contained in the file .windowrc in the 
user’s home directory are executed. If it does not exist, two equal sized windows spanning the terminal 
screen are created by default. 


The command line options are: 


—c command 
Executes the string command as a long command (see below) before doing anything else. 


-d ~ Ignores the .windowrc file and creates the two default windows instead. 


—e escape-char 
Sets the escape character to escape-char. Escape-char can be a single character, or in the form “X 
where X is any character, meaning control-X. 


-f Stands for fast. Does not perform any startup action. 
+t _ Turns on terse mode (see terse command below). 


PROCESS ENVIRONMENT 


With each newly created window, a shell program is spawned with its process environment tailored to that 
window. Its standard input, output, and diagnostic file descriptors are bound to one end of either a 
pseudo-terminal (pty (4)) or a UNIX domain socket (socketpair (4)). If a pseudo-terminal is used, then its 
special characters and modes (see stty (1)) are copied from the physical terminal. A termcap (5) entry 
tailored to this window is created and passed as environment (environ (5)) variable TERMCAP. The 
termcap entry contains the window’s size and characteristics as well as information from the physical ter- 
minal, such as the existence of underline, reverse video, and other display modes, and the codes produced 
by the terminal’s function keys, if any. In addition, the window size attributes of the pseudo-terminal are 
set to reflect the size of this window, and updated whenever it is changed 2 the user. In particular, the edi- 
tor vi(1) uses this information to redraw its display. 
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OPERATION 

During normal execution, window can be in one of two states: conversation mode or command mode. In 
conversation mode, the terminal’s real cursor is placed at the cursor position of a particular window--called 
the current window--and input from the keyboard is sent to the process in that window. The current win- 
dow is always on top of all other windows, except those in foreground. In addition, it is set apart by 
highlighting its identifier and label in reverse video. 

Typing window’s escape character (normally “P) in conversation mode switches it into command mode. In 
command mode, the top line of the terminal screen becomes the command prompt window, and window 
interprets input from the keyboard as commands to manipulate windows. 


There are two types of commands: short commands are usually one or two key strokes; long commands are 
strings either typed by the user in the command window (see the ‘‘:’? command below), or read from a file 
(see source below). 


SHORT COMMANDS 
Below, # represents one of the digits ‘‘1’’ to ‘‘9”’ corresponding to the windows 1 to 9. “X means control- 
X, where X is any character. In particular, “* is control-*. Escape is the escape key, or ‘/. 


All entries are in alphabetical order, whether they use a control character or not. 
# Select window # as the current window and return to conversation mode. 
Fo# Selects window # but stay in command mode. ; 
ae Selects the previous window and return to conversation mode. This is useful for toggling between 
two windows. 

escape Returns to conversation mode. 

2 Lists a short summary of commands. 


: Enters a line to be executed as long commands. Normal line editing characters (erase character, 
erase word, erase line) are supported. 


“B Scrolls the current window up by the full window size. 


c# Closes window #. The process in the window is sent the hangup signal (see kill (1)). Csh (1) 
should handle this signal correctly and cause no problems. 


‘D _ Scrolls the current window down by half the window size. 
*E Scrolls the current window down by one line. 

‘F Scrolls the current window down by the full window size. 

h Moves the cursor of the current window left by one column. 
j Moves the cursor of the current window down by one line. 

k Moves the cursor of the current window up by one line. 

] Moves the cursor of the current window right by one column. 


*L Redraws the screen. 


m# Moves window # to another location. A box in the shape of the window is drawn on the screen to 
. indicate the new position of the window, and the same keys as those for the w command are used 
to position the box. The window can be moved partially off-screen. 


M# Moves window # to its previous position. 


“P Return to conversation mode and write “P to the current window. Thus, typing two “P’s in conver- 
sation mode sends one to the current window. If the window escape is changed to some other 
character, that character takes the place of “P here. 


q -_ Exits window. Requests confirmation before exiting. 
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‘Q Starts output in the current window. 
s# Changes the size of window #. The user is prompted to enter the new lower right corner of the 


window. A box is drawn to indicate the new window size. The same keys used in w and m are 
used to enter the position. 

S# Changes window # to its previous size. 

‘Ss Stops output in the current window. 

‘U Scrolls the current window up by half the window size. 

w Creates a new window. The user is prompted for the positions of the upper left and lower right 


a tee 


comers of the window. The cursor is placed on the screen and the keys ‘‘h’’, ‘‘j’’, “*k’’, and 
move the cursor left, down, up, and right, respectively. The keys ‘‘H’’, ‘‘J’’, °‘K’’, and “‘L”’ — 
move the cursor to the respective limits of the screen. Typing a number before the movement 
keys repeats the movement that number of times. Return enters the cursor position as the upper 
left corner of the window. The lower right corner is entered in the same manner. During this pro- 
cess, the placement of the new window is indicated by a rectangular box drawn on the screen, 
corresponding to where the new window will be framed. Typing escape at any point cancels this 
command. 


This window becomes the current window, and is given the first available ID. The default buffer 
size is used (see nline command below). 


Only fully visible windows can be created this way. 
Pp & - Scrolls the current window up by one line. 
“Z Suspends window. 


LONG COMMANDS | 
Long commands are a sequence of statements parsed much like a programming language, with a syntax 
similar to that of C. Numeric and string expressions and variables are supported, as well as conditional 
Statements. 


There are two data types: string and number. A string is a sequence of letters or digits beginning with a 
letter. ‘‘_’’ and ‘‘.”’ are considered letters. Alternately, non-alphanumeric characters can be included in 
Strings by quoting them in ‘‘"’’ or escaping them with ‘‘\’’. In addition, the ‘‘\’’ sequences of C are sup- 
ported, both inside and outside quotes (e.g., ‘“\n’’ is a new line, ‘‘\r’’ a carriage return). For example, these 
are legal strings: abcde0 1234, "&#$°+&#", ab"$#"cd, ab\$\#cd, "/usr/ucb/window". 


A number is an integer value in one of three forms: a decimal number, an octal number preceded by “‘0’’, 
or a hexadecimal number preceded by ‘‘Ox’’ or ‘‘OX’’. The natural machine integer size is used (i.e., the 
signed integer type of the C compiler). As in C, a non-zero number represents a boolean true. 


The character ‘‘#’’ begins a comment which terminates at the end of the line. 


A statement is either a conditional or an expression. Expression statements are terminated with a new line 
or ‘‘;’’. To continue an expression on the next line, terminate the first line with ‘‘\’’. 


CONDITIONAL STATEMENT 7 
Window has a single control structure: the fully bracketed if statement in the form 
if <expr> then 
<statement> 


elsif <expr> then 
<statement> 


else 
_<Statement> 
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endif 
The else and elsif parts are optional, and the latter can be repeated any number of times. <Expr> must be 
numeric. 


EXPRESSIONS 
Expressions in window are similar to those in the C language, with most C operators supported on numeric 
operands. In addition, some are overloaded to operate on strings. 


When an expression is used as a statement, its value is discarded after evaluation. Therefore, only expres- 
sions with side effects (assignments and function calls) are useful as statements. 


Single valued (no arrays) variables are supported, of both numeric and string values. Some variables are 
predefined. They are listed below. 


The operators in order of increasing precedence: 


<expri> = <expr2> 
Assignment. The variable of name <expr!>, which must be string valued, is assigned the result 
of <expr2>. Returns the value of <expr2>. 


<expri> ? <expr2>: <expr3> 
Returns the value of <expr2> if <expri> evaluates true (non-zero numeric value); returns the 
value of <expr3> otherwise. Only one of <expr2> and <expr3> is evaluated. <Expr1> must be 
numeric. 


<expr1> || <expr2> 
Logical or. Numeric values only. Short circuit evaluation is supported (i.e., if <expr1> evaluates 
true, then <expr2 > is not evaluated). 


<exprl> && <expr2> 
Logical and with short circuit evaluation. Numeric values only. 


<expri> | <expr2> 
Bitwise or. Numeric values only. 


<expri>* <expr2> 
Bitwise exclusive or. Numeric values only. 


<expri> & <expr2> 
Bitwise and. Numeric values only. 


<expril> == <expr2>, <expr1> != <expr2> 
Comparison (equal and not equal, respectively). The boolean result (either 1 or 0) of the com- 
parison is retumed. The operands can be numeric or string valued. One string operand forces the 
other to be converted to a string in necessary. 


<expri> < <expr2>, <expri> > <expr2>, 
Less than, greater than, less than or equal to, greater than or equal to. Both numeric and string 
values, with automatic conversion as above. 

<exprl1> << <expr2>, <expri> >> <expr2> 
If both operands are numbers, <expr! > is bit shifted left (or right) by <expr2> bits. If <expr1> 
is a String, then its first (or last) <expr2> characters are returns (if <expr2> is also a string, then 
its length is used in place of its value). 


<exprl> + <expr2>, <expr1> - <expr2> . 
Addition and subtraction on numbers. For ‘‘+’’, if one argument is a string, then the other is con- 
verted to a string, and the result is the concatenation of the two strings. 


<exprl> * <expr2>, <expr1> / <expr2>, 
Multiplication, division, modulo. Numbers only. 


-<expr>, “<expr>, !<expr>, $<expr>, $?<expr> 
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The first three are unary minus, bitwise complement and logical complement on numbers only. 
The operator, ‘‘$’’, takes <expr> and returns the value of the variable of that name. If <expr> is 
numeric with value n and it appears within an alias macro (see below), then it refers to the nth 
argument of the alias invocation. ‘‘$?’’ tests for the existence of the variable <expr>, and returns 
1 if it exists or 0 otherwise. 
<expr>(<arglist>) — 

Function call. <Expr> must be a string that is the unique prefix of the name of a builtin window 
function or the full name of a user defined alias macro. In the case of a builtin function, <arglist> 
can be in one of two forms: 

<exprl>, <expr2>,... 

argnamel = <exprl>, argname2 = <expr2>, .. 
The two forms can in fact be intermixed, but the result is unpredictable. Most arguments can be 
omitted; default values will be supplied for them. The argnames can be unique prefixes of the the 
argument names. The commas separating arguments are used only to disambiguate, and can usu- 
ally be omitted. 


Only the first argument form is valid for user defined aliases. Aliases are defined using the alias 
builtin function (see below). Arguments are accessed via a variant of the variable mechanism (see 
“*$”’ operator above). 


Most functions return value, but some are used for side effect only and so must be used as state- 
ments. When a function or an alias is used as a statement, the parenthesis surrounding the argu- 
ment list may be omitted. Aliases return no value. 


BUILTIN FUNCTIONS | 
The arguments are listed by name in their natural order. Optional arguments are in square brackets (“‘[ ]’’). 
Arguments that have no names are in angle brackets (‘‘<> 


alias([<string>], [<string-list>]) 
If no argument is given, all currently defined alias macros are listed. Otherwise, <string> is 
defined as an alias, with expansion <string-list>. The previous definition of <string>, if any, is 
returned, Default for <string-list> is no change. 


close(<window-list>) 
Close the windows specified in <window-list>. If <window-list> is the word all, than all win- 
dows are closed. No value is returned. 


cursormodes([modes]) | 
Set the window cursor to modes. Modes is the bitwise or of the mode bits defined as the variables 
m_ul (underline), m_rev (reverse video), m_blk (blinking), and m_grp (graphics, terminal depen- 
dent). Return value is the previous modes. . Default is no change. For example, 
cursor($m_revi$m_blk) sets the window cursors to blinking reverse video. 


echo([window], {<string-list>]) 
Write the list of strings, <string-list>, to window, separated by spaces and terminated with a new 
line. The strings are only displayed in the window, the processes in the window are not involved 
(see write below). No value is returned. Default is the current window. 


escape([escapec]) 
Set the escape character to escape-char. Returns the old escape character as a one character 
string. Default is no change. Escapec can be a string of a single character, or in the form “X, 
meaning control-X. 


foreground([window], [flag]) 
| Move window in or out of foreground. Flag can be one of on, off, yes, no, true, or false, with 
-Obvious meanings, or it can be a numeric expression, in which case a non-zero value is true. 
Returns the old foreground flag as a number. Default for window is the current window, default 

for flag is no change. 


May 12, 1986 | INTEGRATED SOLUTIONS 4.3 BSD 5 


WINDOW (1) UNIX Programmer’s Manual WINDOW (1) 


label({window], [label]) 
Set the label of window to label. Returns the old label as a string. Default for window is the 
current window, default for label is no change. To turn off a label, set it to an empty string ("""). 


list. No arguments. List the identifiers and labels of all windows. No value is returned. 


nline({nline}) 
Set the default buffer size to nline. Initially, it is 48 lines. Returns the old default buffer size. 
Default is no change. Using a very large buffer can slow the program down considerably. 


select([window]) 
Make window the current window. The previous current window is returned. Default is no 
change. 


shell([<string-list>]) 
Set the default window shell program to <string-list>. Returns the first string in the old shell set- 
ting. Default is no change. Initially, the default shell is taken from the environment variable 
SHELL, 


source(filename) 
Read and execute the long commands in filename. Returns -1 if the file cannot be read, 0 other- 
wise. 


terse([flag]) . 
Set terse mode to flag. In terse mode, the command window stays hidden even in command 
mode, and errors are reported by sounding the terminal’s bell. Flag can take on the same values 
as in foreground above. Returns the old terse flag. Default is no change. 


unalias(alias) 
Undefine alias. Returns -1 if alias does not exist, 0 otherwise. 


unset(variable) 
Undefine variable. Returns -1 if variable does not exist, 0 otherwise. 


variablesO 
No arguments. List all variables. No value is returned. 


window/([row], [column], [nrow], [ncol], [nline], [frame], 
[pty], [mapnl], [shell]) . 
Open a window with upper left corner at row, column and size nrow, ncol. If nline is specified, 
then that many lines are allocated for the text buffer. Otherwise, the default buffer size is used. 
Default values for row, column, nrow, and ncol are, respectively, the upper, left-most, lower, or 
right-most extremes of the screen. Frame, pty, and mapni are flag values interpreted in the same 
way as the argument to foreground (see above); they mean, respectively, put a frame around this 
window (default true), allocate pseudo-terminal for this window rather than socketpair (default 
true), and map new line characters in this window to carriage return and line feed (default true if 
socketpair is used, false otherwise). Shell is a list of strings that will be used as the shell program 
to place in the window (default is the program specified by shell, see below). The created 
window’s identifier is returned as a number. 

write({window], [<string-list>]) 
Send the list of strings, <string-list>, to window, separated by spaces but not terminated with a 
new line. The strings are actually given to the window as input. No value is returned. Default is 
the current window. 


PREDEFINED VARIABLES 
These variables are for information only. Redefining them does not affect the internal operation of win- 
dow. . 


baud = The baud rate as a number between 50 and 38400. 
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modes 


m_blk 
m_grp 
m_rev 
m_ul 
ncol 
nrow 


term 


FILES . 
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The display modes (reverse video, underline, blinking, graphics) supported by the physical termi- 
nal. The value of modes is the bitwise or of some of the one bit values, m_blk, m_grp, m_rev, and 
m_ul (see below). These values are useful in setting the window cursors’ modes (see cursormodes 
above). 


The blinking mode bit. 

The graphics mode bit (not very useful). 

The reverse video mode bit. 

The underline mode bit. 

The number of columns on the physical screen. 
The number of rows on the physical screen. 


The terminal type. The standard name, found in the second name field of the terminal’s 
TERMCAP entry, is used. 


“/.windowrc startup command file. 
/dev/{pt]ty [pq]? . pseudo-terminal devices. 


DIAGNOSTICS 


Should be self explanatory. 
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NAME 


write — write to another user 


SYNOPSIS 


write user [ ttyname ] 


DESCRIPTION 


Write copies lines from your terminal to that of another user. When first called, it sends the message 
Message from yourname@yoursystem on yourttyname at time... 


To begin two-way communication, the recipient of the message should write back at this point. If he does 
not, the write session ends when you type an ’EOT’ character. If the recepient does write back, communi- 
Cation continues until an end of file is read from the terminal or an interrupt is sent. At that point write 
writes ‘EOT’ on the other terminal and exits. 


To write to a user who is logged in more than once, you can use the ttyname argument to indicate the 
appropriate terminal name. 


Users can use the mesg command to grant or deny permission to write to their terminals. By default, mesg 
allows writing. Certain commands, in particular nroff and pr(1) disallow messages in order to prevent 
messy output. 


If the character ‘!’ appears at the beginning of a line, write calls the shell to execute the rest of the line as a 
command. 


The following protocol is suggested for using write. When you first write to another user, wait for him to 
write back before starting to send. Each party should end each message with a distinctive signal—{o) for 
‘over’ is conventional—so that the other may reply. Type (oo) for ‘over and out’ when you are ready to 
end the conversation. 


FILES : 
/etc/utmp to find user 
/bin/sh to execute ‘!’ 
SEE ALSO 


mesg(1), who(1), mail(1) 
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NAME 
xsend, xget, enroll — secret mail 
SYNOPSIS 
xsend person 
xget 
enroll 
DESCRIPTION 
_ These commands implement a secure communication channel similar to the mail(1) program. Unlike the 
mail program, however, this channel ensures that no one can read the messages except the intended reci- 
pient. To do this, these commands employ a public-key cryptosystem using knapsacks. . 
Use the enroll command to set up the password check that lets you receive mail. Enroll asks you for a 
password that you must enter at the xget prompt in order to receive secret mail. 
To receive secret mail, type xget. It asks for your password, then gives you the messages. 
To send secret mail, use xsend in the same manner as the ordinary mail command. (However, it will 
accept only one target). A message announcing the receipt of secret mail is also sent by ordinary mail. 
FILES . 
‘/usr/spool/secretmail/* key: keys 
/ust/spool/secretmail/* [0-9]: messages 
SEE ALSO 
mail(1) 
BUGS 


It should be integrated with ordinary mail. The announcement of secret mail makes traffic analysis possi- 
ble. . 
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NAME 


xstr — extract strings from C programs to implement shared strings 


SYNOPSIS 


xstr [-c] [—] [file] 


DESCRIPTION 


FILES 


Xstr maintains a file strings into which strings in component parts of a large program are hashed. These 
strings are replaced with references to this common area. This serves to implement shared constant strings, 
most useful if they are also read-only. 


The command 
xstr —c name 


extracts the strings from the C source in name and replaces string references with expressions of the form 
(&xstr[number]) for some number. The command also prepends an appropriate declaration of xstr to the 
file and places the resulting C text in the file x.c to be compiled. The strings from this file are placed in the 
strings data base if they are not there already. Repeated strings and strings which are suffices of existing 
Strings do not cause changes to the data base. 


After all components of a large program have been compiled a file xs.c declaring the common xstr space 
can be created by a command of the form. 


xstr 


This xs.c file should then be compiled and loaded with the rest of the program. If possible, the array can be 
made read-only (shared) saving space and swap overhead. 


Xstr can also be used on a single file. A command 
xstr name 
creates files x.c and xs.c as before, without using or affecting any strings file in the same directory. 


It may be useful to run xstr after the C preprocessor if any macro definitions yield strings or if there is con- 
ditional code which contains strings which may not, in fact, be needed. Xstr reads from its standard input 
when the argument ‘—’ is given. An appropriate command sequence for running xstr after the C preproces- 
sor is: 

cc —E name.c | xstr —c — 

CC ~C X.C 

mv X.0 name.o 


Xstr does not touch the file strings unless new items are added, thus make can avoid remaking xs.o unless 
truly necessary. 


strings Data base of strings 

X.C Massaged C source 

xS.C C source for definition of array ‘xstr’ 

/tmp/xs* Temp file when ‘xstr name’ doesn’t touch strings 


SEE ALSO 


BUGS 


mkstr(1) 


If a string is a suffix of another string in the data base, but the shorter string is seen first by xstr both strings 
will be placed in the data base, when just placing the longer one there will do. 
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NAME - 
| yacc — yet another compiler-compiler 
SYNOPSIS 

yace [ options | grammar 


DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple automaton which executes an LR(1) 
parsing algorithm. The grammar may be ambiguous. Yacc uses specified precedence rules to break ambi- 
guities. 

The output file, y.tab.c , must be compiled by the C compiler to produce a program yyparse. This program 
must be loaded with the lexical analyzer program, yylex, as well as main and yyerror, an error handling 
routine. These routines must be supplied by the user. Lex(1) is useful for creating lexical analyzers usable 
by yacc. 


OPTIONS 


-d Generates the file y.tab.h with the define statements that associate the yacc-assigned ‘token codes’ 
with the user-declared ‘token names’. This allows source files other than y.tab.c to access the 


token codes. 
-V Prepares the file y.output, which contains a description of the parsing tables and a report on 
conflicts generated by ambiguities in the grammar. 
FILES 
y.output 
y.tab.c 
y.tab.h defines for token names 
yacc.tmp, yacc.acts — temporary files . 
/usr/lib/yaccpar parser prototype for C programs 
SEE ALSO 
lex(1) 


LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 
YACC — Yet Another Compiler Compiler by S. C. Johnson. 


DIAGNOSTICS 
Yacc reports (on the standard output) the number of reduce-reduce and shift-reduce conflicts. The y.output 
file contains a more detailed report. Yacc also reports rules not reachable from the start symbol. 


BUGS , 
Because filenames are fixed, no more than one yacc process can be active in a given directory at a time. 
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NAME 

yes — print text repeatedly 
SYNOPSIS 

yes [ text J 


DESCRIPTION 
Yes repeatedly outputs ‘‘y’’. If you type yes and some text on the command line, yes repeats the text ad 
infinitum. Termination is by rubout. 


EXAMPLE 
yes "This is a test.” 
outputs: 


This is a test. 
This is a test. 
This is a test. 
This is a test. 


and so on until you type rubout. 
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NAME 
adventure — an exploration game 


SYNOPSIS 
/usr/games/adventure _ 


DESCRIPTION 
The object of the game is to locate and explore Colossal Cave, find the treasures hidden there, and bring 
them back to the building with you. The program is self-descriptive to a point, but part of the game is to 
discover its rules. 
To terminate a game, type ‘quit’; to save a game for later resumption, type ‘suspend’. 

BUGS | 
Saving a game creates a large executable file instead of just the information needed to resume the game. 
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_ NAME 

arithmetic — provide drill in number facts 
SYNOPSIS | 

/usr/games/arithmetic [ +—x/ ] [ range ] 


DESCRIPTION 
Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the answer is 
correct, it types back ‘‘Right!’’, and a new problem. If the answer is wrong, it replies ‘“What?’’, and waits 
for another answer. After every twenty —— it publishes statistics on correctness and the time 
required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be generated; +—x/ respectively cause addi- 
tion, subtraction, multiplication, and division problems to be generated. One or more characters can be 
given; if more than one is given, the different types of problems will be mixed in random order; default is 
+-. 

Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and quotients 
will be less than or equal to the value of range. Default range is 10. 


At the start, all numbers less than or equal to range are equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed become more likely to reappear. 


AS a matter of educational philosophy, the program will not give correct answers, since the learner should, 
in principle, be able to calculate them. Thus the program is intended to provide drill for someone just past 
the first learning stage, not to teach number facts de novo, For almost all users, the relevant statistic should 
be time per problem, not percent correct. 


May 6, 1986 INTEGRATED SOLUTIONS 4.3 BSD | 1 


BACKGAMMON (6) UNIX Programmer’s Manual BACKGAMMON (6) 


NAME 
backgammon — the game 


SYNOPSIS 
/usr/games/backgammon 


DESCRIPTION 
This program does what you expect. It will ask whether you need instructions. 
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NAME 
banner — print large banner on printer 


SYNOPSIS 
_ /usr/games/banner [ —wn ] message ... 


DESCRIPTION ' 
Banner prints a large, high quality banner on the standard output. If the message is omitted, it prompts for 
and reads one line of its standard input. If —-w is given, the output is scrunched down from a width of 132 
ton , suitable for a narrow terminal. If n is omitted, it defaults to 80. 


The output should be printed on a hard-copy device, up to 132 columns wide, with no breaks between the 
pages. The volume is great enough that you may want a printer or a fast hardcopy terminal, but if you are 
patient, a decwriter or other 300 baud terminal will do. 


BUGS 
Several ASCII characters are not defined, notably <, >, [, ], \,*, _, {, }, |, and ~. Also, the characters ", ’, 
and & are funny looking (but in a useful way.) 


The —w option is implemented by skipping some rows and columns. The smaller it gets, the grainier the 
output. Sometimes it runs letters together. 
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NAME 

battlestar — a tropical adventure game 
SYNOPSIS 

battlestar [ -r (recover a saved game) ] 


DESCRIPTION 
Battlestar is an adventure game in the classic style. However, it’s slightly less of a puzzle and more a 
game of exploration. There are a few magical words in the game, but on the whole, simple English should 
suffice to make one’s desires understandable to the parser. 

THE SETTING 
In the days before the darkness came, when battlestars ruled the heavens... 


Three He made and gave them to His daughters, 
Beautiful nymphs, the goddesses of the waters. 

One to bring good luck and simple feats of wonder, 

Two to wash the lands and churn the waves asunder, 
Three to rule the world and purge the skies with thunder. 


In those times great wizards were known and their powers were beyond belief. They could take any object 
from thin air, and, uttering the word ‘su’ could disappear. 


In those times men were known for their lust of gold and desire to wear fine weapons. Swords and coats of 
mail were fashioned that could withstand a laser blast. 


But when the darkness fell, the rightful reigns were toppled. Swords and helms and heads of state went 
rolling across the grass. The entire fleet of battlestars was reduced to a single ship. 


SAMPLE COMMANDS 


take --- take an object 

drops --- drop an object 

wear --- wear an object you are holding 
draw s--- Carry an object you are wearing | 
puton --- take an object and wear it 

take off -- draw an object and drop it 


throw <object> <direction> 


! <shell esc> 


IMPLIED OBJECTS 
>-: take watermelon 
watermelon: 
Taken. 
>-: eat 
watermelon: 
Eaten. 
>-: take knife and sword and apple, drop all 
knife: 
Taken. 
broadsword: 
Taken. 
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apple: 
Taken. 
knife: — 
Dropped. 
broadsword: 
Dropped. 
apple: 
Dropped. 
>-: get 
knife: 
Taken. 


Notice that the "shadow" of the next word stays around if you want to take advantage of it. That is, saying 
"take knife” and then “drop” will drop the knife you just took. 

SCORE & INVEN 
The two commands "score" and "inven" will print out your current status in the game. 


SAVING A GAME 
The command "save" will save your game in a file called "Bstar." You can recover a saved game by using 
the "-r" option when you start up the game. 

DIRECTIONS | . 

The compass directions N, S, E, and W can be used if you have a compass. If you don’t have a compass, 
you'll have to say R, L, A, or B, which stand for Right, Left, Ahead, and Back. Directions printed in room 
descriptions are always printed in R, L, A, & B relative directions. 

HISTORY . 

I wrote Battlestar in 1979 in order to experiment with the niceties of the C Language. Most interesting 
things that happen in the game are hardwired into the code, so don’t send me any hate mail about it! 
Instead, enjoy art for art’s sake! 

AUTHOR 
David Riggle 

INSPIRATION & ASSISTANCE 
Chris Guthrie 
Peter Da Silva 
Kevin Brown 
Edward Wang 
Ken Arnold & Company 

BUGS 
Countless. 


FAN MAIL 
Send to edward% ucbarpa@Berkeley.arpa, chris%ucbcory@berkeley.arpa, riggle.pa@xerox.arpa. 
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NAME 
bcd — convert to antique media 


SYNOPSIS 
/usr/games/bed text 


DESCRIPTION 
Bcd converts the literal text into a form familiar to old-timers. 


SEE ALSO 
dd(1) 
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NAME 
boggle — play the game of boggle 


SYNOPSIS a: 
/usr/games/boggle [ + ] [ ++ ] 


DESCRIPTION 
This program is intended for people wishing to sharpen their skills at Boggle (TM Parker Bros.). If you 
invoke the program with 4 arguments of 4 letters each, (e.g. ‘‘boggle app! epie moth erhd’’) the program 
forms the obvious Boggle grid and lists all the words from /ust/dict/words found therein. If you invoke the 
program without arguments, it will generate a board for you, let you enter words for 3 minutes, and then 
tell you how well you did relative to /usr/dict/words. 


The object of Boggle is to find, within 3 minutes, as many words as possible in a 4 by 4 grid of letters. 
Words may be formed from any sequence of 3 or more adjacent letters in the grid. The letters may join hor- 
izontally, vertically, or diagonally. However, no position in the grid may be used more than once within 
any one word. In competitive play amongst humans, each player is given credit for those of his words 
which no other player has found. 


In interactive play, enter your words separated by spaces, tabs, or newlines. A bell will ring when there is 
2:00, 1:00, 0:10, 0:02, 0:01, and 0:00 time left. You may complete any word started before the expiration 
of time. You can surrender before time is up by hitting *break’. While entering words, your erase character 
is only effective within the current word and your line kill character is ignored. 


Advanced players may wish to invoke the program with 1 or 2 +’s as the first argument. The first + 
removes the restriction that positions can only be used once in each word. The second + causes a position 
to be considered adjacent to itself as well as its (up to) 8 neighbors. 
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NAME 


canfield, cfscores — the solitaire card game canfield 


SYNOPSIS 


/usr/games/canfield 
/usr/games/cfscores 


DESCRIPTION 


FILES 


BUGS 


If you have never played solitaire before, it is recommended that you consult a solitaire instruction book. 
In Canfield, tableau cards may be built on each other downward in alternate colors. An entire pile must be 
moved as a unit in building. Top cards of the piles are available to be played on foundations, but never into 
empty spaces. 

Spaces must be filled from the stock. The top card of the stock also is available to be played on founda- 
tions or built on tableau piles. After the stock is exhausted, tableau spaces may be filled from the talon and 
the player may keep them open until he wishes to use them. 


Cards are dealt from the hand to the talon by threes and this repeats until there are no more cards in the 
hand or the player quits. To have cards dealt onto the talon the player types *ht’ for his move. Foundation 
base cards are also automatically moved to the foundation when they become available. 


The command ’c’ causes canfield to maintain card counting statistics on the bottom of the screen. When 
properly used this can greatly increase one’s chances of winning. 


The rules for betting are somewhat less strict than those used in the official version of the game. The initial 
deal costs $13. You may quit at this point or inspect the game. Inspection costs $13 and allows you to 
make as many moves as possible without moving any cards from your hand to the talon. (The initial deal 
places three cards on the talon; if all these cards are used, three more are made available.) Finally, if the 
game seems interesting, you must pay the final installment of $26. At this point you are credited at the rate 
of $5 for each card on the foundation; as the game progresses you are credited with $5 for each card that is 
moved to the foundation. Each run through the hand after the first costs $5. The card counting feature 
costs $1 for each unknown card that is identified. If the information is toggled on, you are only charged for 
cards that became visible since it was last turned on. Thus the maximum cost of information is $34. Play- 
ing time is charged at a rate of $1 per minute. 


With no arguments, the program cfscores prints out the current status of your canfield account. If a user 
name is specified, it prints out the status of their canfield account. If the —a flag is specified, it prints out 
the canfield accounts for all users that have played the game since the database was set up. 


/usr/games/canfield the game itself 
/usr/games/cfscores the database printer 
/usr/games/lib/cfscores the database of scores 


It is impossible to cheat. 


AUTHORS 


Originally written: Steve Levine 
Further random hacking by: Steve Feldman, Kirk McKusick, Mikey Olson, and Eric Allman. 
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NAME 
chess — the game of chess 
SYNOPSIS | 
/usr/games/chess 
DESCRIPTION 
Chess is a computer program that plays class D chess. Moves may be given either in standard (descriptive) 
notation or in algebraic notation. The symbol ‘+’ is used to specify check; ‘o-o’ and ‘o-0-0’ specify cas- 
tling. To play black, type ‘first’; to print the board, type an empty line. 
Each move is echoed in the appropriate notation followed by the program’s reply. 


FILES 
- fusr/lib/chess binary image to run in compatibility mode 
DIAGNOSTICS | | 
The most cryptic diagnostic is ‘eh?’ which means that the input was syntactically incorrect. 
BUGS 


Pawns may be promoted only to queens. The book of opening moves has disappeared. 
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NAME 
ching — the book of changes and other cookies 


SYNOPSIS 
/usr/games/ching [ hexagram ] 


DESCRIPTION 
The I Ching or Book of Changes is an ancient Chinese oracle that has been in use for centuries as a source 
of wisdom and advice. 


The text of the oracle (as it is sometimes known) consists of sixty-four hexagrams, each symbolized by a 
particular arrangement of six straight (——) and broken (— —) lines. These lines have values ranging from 
six through nine, with the even values indicating the broken lines. 


Each hexagram consists of two major sections. The Judgement relates specifically to the matter at hand 
(E.g., ‘*It furthers one to have somewhere to go.’’) while the Image describes the general attributes of the 
hexagram and how they apply to one’s own life (‘‘Thus the superior man makes himself strong and untir- 
ing.’’). 

When any of the lines have the values six or nine, they are moving lines; for each there is an appended 
judgement which becomes significant. Furthermore, the moving lines are inherently unstable and change 
into their opposites; a second hexagram (and thus an additional judgement) is formed. 


Normally, one consults the oracle by fixing the desired question firmly in mind and then casting a set of 
Changes (lines) using yarrow-—stalks or tossed coins. The resulting peneerem will be the answer to the 
question. 


Using an algorithm suggested by S. C. Johnson, the UNIX oracle simply reads a question from the stan- 

dard input (up to an EOF) and hashes the individual characters in combination with the time of day, pro- 

cess id and any other magic numbers which happen to be lying around the system. The resulting value is 

used as the seed of a random number generator which drives a simulated coin—toss divination. The answer 
- is then piped through nroff for formatting and will appear on the standard output. 


For those who wish to remain steadfast in the old traditions, the oracle will also accept the results of a per- 
sonal divination using, for example, coins. To do this, cast the change and then type the resulting line 
values as an argument. 


The impatient modern may prefer to settle for Chinese cookies; try JOREARERG): It furthers one to see the 
great man. 
DIAGNOSTICS 
The great prince issues commands, 
Founds states, vests families with fiefs. 
Inferior people should not be employed. 


BUGS 
Waiting in the mud 
Brings about the arrival of the enemy. 
If one is not extremely careful, 


Somebody may come up from behind and strike him. 
Misfortune. 
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NAME | , 
cribbage — the card game cribbage © 


SYNOPSIS 
/usr/games/cribbage [ options ] name ... 


DESCRIPTION | 
Cribbage plays the card game cribbage, with the program playing one hand and the user the other. The — 
program will initially ask the user if the rules of the game are needed—f so, it will print out the appropri- 
ate section from According to Hoyle with more (1). 


Cribbage first asks the player whether he wishes to play a short game (‘‘once around’’, to 61) or a long 
game (‘‘twice around’’, to 121). A response of ‘s’ will result in a short game, any other response will play 
a long game. 


At the start of the first game, the program asks the player to cut the deck to determine who gets the first 
crib. The user should respond with a number between 0 and 51, indicating how many cards down the deck 
is to be cut. The player who cuts the lower ranked card gets the first crib. If more than one game is played, 
the loser of the previous game gets the first crib in the current game. 


For each hand, the program first prints the player’s hand, whose crib it is, and then asks the player to dis- 
card two cards into the crib. The cards are prompted for one per line, and are typed as explained below. 


After discarding, the program cuts the deck (if it is the player’s crib) or asks the player to cut the deck (if | 
it’s its crib); in the latter case, the appropriate response is a number from 0 to 39 indicating how far down 
the remaining 40 cards are to be cut. 


After cutting the deck, play starts with the non-dealer (the person who doesn’t have the crib) leading the 
first card. Play continues, as per cribbage, until all cards are exhausted. The program keeps track of the 
scoring of all points and the total of the cards on the table. 


After play, the hands are scored. The program requests the player to score his hand (and the crib, if it is 
his) by printing out the appropriate cards (and the cut card enclosed in brackets). Play continues until one 
player reaches the game limit (61 or 121). 


A Carriage return when a numeric input is expected is equivalent to typing the lowest legal value; when 
Cutting the deck this is equivalent to choosing the top card. 


Cards are specified as rank followed by suit. The ranks may be specified as one of: ‘a’, ‘2’, ‘3’, ‘4’, ‘5’, 
aa ‘7’, °8’, ‘9, ‘tv’, ‘7’, ‘q’, and ‘k’, or alternatively, one of: ‘‘ace’’, ‘‘two’’, ‘‘three’’, ‘‘four’’, ‘‘five’’, 

*‘six’’, “‘seven’’, ‘‘eight’’, ‘‘nine’’, ‘‘ten’’, ‘‘jack’’, “‘queen’’, and ‘‘king’’. Suits may be specified as: ‘s’, 
‘h’, ‘d’, and ‘c’, or alternatively as: Tega “‘hearts’’, ‘‘diamonds’’, and ‘‘clubs’’. A card may be 
specified as: <rank> ‘‘ ’’ <suit>, or: <rank> ‘‘ of ’’ <suit>. If the single letter rank and suit designations 
are used, the space separating the suit and rank may be left out. Also, if only one card of the desired rank 
is playable, typing the rank is sufficient. For example, if your hand was ‘‘2H, 4D, SC, 6H, JC, KD’’ and it 
was desired to discard the king of diamonds, any of the following could be typed: ‘‘k’’, ‘‘king’’, ‘‘kd’’, ‘‘k 
d’’, ‘‘k of d’’, ‘‘king d’’, ‘‘king of a”, **k diamonds’’, ‘‘k of diamonds’’, ‘‘king diamonds’’, or ‘‘king of 
diamonds’’. 


OPTIONS 
Cribbage options include: 


—e When the player makes a mistake scoring his hand or crib, provide an explanation of the correct 
score. (This is especially useful for beginning players.) 


—q Print a shorter form of all messages — this is only recommended for users who have played the 
game without specifying this option. 


-r Instead of asking the player to cut the deck, the program will randomly cut the deck. 
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FILES 
/usr/games/cribbage 


AUTHORS 
Earl T. Cohen wrote the logic. Ken Amold added the screen oriented interface. 
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NAME 
doctor — interact with a psychoanalyst 

SYNOPSIS 
/usr/games/doctor 

' DESCRIPTION | | 
Doctor is a lisp-language version of the legendary ELIZA program of Joseph Weizenbaum. This script 
"simulates" a Rogerian psychoanalyst. Type in lower case, and when you get tired or bored, type your 
interrupt character (either control-C or Rubout). Remember to type two carriage returns when you want it 
to answer. 
In order to run this you must have a Franz Lisp system in /ust/ucb/lisp. 

AUTHORS 
Adapted for Lisp by Jon L White, moved to Franz by John Foderaro, from an original script by Joseph 
Weizenbaum. 


May 20, 1985 INTEGRATED SOLUTIONS 4.3 BSD _ 1 


FISH (6) UNIX Programmer’s Manual FISH (6) 


NAME 
fish — play ‘‘Go Fish” 


SYNOPSIS 
/usr/games/fish 


DESCRIPTION | 

Fish plays the game of ‘‘Go Fish’’, a childrens’ card game. The Object is to accumulate ‘books’ of 4 cards 
with the same face value. The players alternate turns. Each turn begins with one player selecting a card 
from his hand, and asking the other player for all cards of that face value. If the other player has one or 
more cards of that face value in his hand, he gives them to the first player, and the first player makes 
another request. Eventually, the first player asks for a card which is not in the second player’s hand: he 
replies ‘GO FISH!’ The first player then draws a card from the ‘pool’ of undealt cards. If this is the card 
he had last requested, he draws again. When a book is made, either through drawing or requesting, the 
cards are laid down and no further action takes place with that face value. 


To play the computer, simply make guesses by typing a, 2, 3, 4, 5, 6, 7, 8, 9, 10, j, q, or k when asked. Hit- 
ting return gives you information about the size of my hand and the pool, and tells you about my books. 
Saying ‘p’ as a first guess puts you into ‘pro’ level. The default is pretty dumb. 
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NAME . 
fortune — print a random, hopefully interesting, adage 
SYNOPSIS 
/usr/games/fortune [ — ] [ options ] file } 
DESCRIPTION | 
Fortune with no arguments prints out a random adage. 
You may specify a file of adages. This file must be created by strfile(6), and be specified in the command 
line as file. You can name only one such file. Fortune ignores any files named after the first one. 


OPTIONS 
-—w Waits before termination for an amount of time calculated from the number of characters in the mes- 
sage. This is useful if it is executed as part of the logout procedure to guarantee that the message can 
be read before the screen is cleared. 


~—s Short messages only. 
-I1 Long messages only. 


FILES 
/usr/games/lib/fortunes.dat 


AUTHOR — 
Ken Armold 


SEE ALSO 
strfile(6) 
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NAME 
hangman — Computer version of the game hangman 


SYNOPSIS 
/usr/games/hangman 


DESCRIPTION 
In hangman, the computer picks a word from the on-line word list and you must try to guess it. The com- 
puter keeps track of which letters have been guessed and how many wrong guesses you have made on the 
screen in a graphic fashion. 

FILES 
/asr/dict/words On-line word list 


AUTHOR 
Ken Arnold 
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NAME . 
hunt — a multi-player multi-terminal game 
SYNOPSIS 
/usr/games/hunt [ options ] [ hostname ] [-l name] 
DESCRIPTION 
The object of the game hunt is to kill off the other players. There are no rooms, no treasures, and no mon- 


sters. Instead, you wander around a maze, find grenades, trip mines, and shoot down walls and players. 
The more players you kill before you die, the better your score is. | 


Hunt normally looks for an active game on the local network; if none is found, it starts one up on the local 
host. One may specify the location of the game by giving the hostname argument. The player name may 
be specified on the command line by using the -1 option. This command syntax was chosen for rlogin/rsh 
compatibility. 


Hunt only works on crt (vdt) terminals with at least 24 lines, 80 columns, and cursor addressing. The 
screen is divided in to 3 areas. On the right hand side is the status area. It shows you how much damage 
you’ve sustained, how many charges you have left, who’s in the game, who’s scanning (the asterisk in 
front of the name), who’s cloaked (the plus sign in front of the name), and other players’ scores. Most of 
the rest of the screen is taken up by your map of the maze, except for the 24th line, which is used for longer 
messages that don’t fit in the status area. 


Hunt uses the same keys to move as vi does, i.e., h,j,k, and 1 for left, down, up, right respectively. To 


change which direction you’re facing in the maze, use the upper case version of the movement key (i.e., 
HJKL). 


Other commands are: 


f — Fire (in the direction you’re facing) (Takes 1 charge) 
2g — Throw grenade (in the direction you’re facing) (Takes 9 charges) 
F — Throw satchel charge (Takes 25 charges) 
G — Throw bomb (Takes 49 charges) 
(0) — Throw small slime bomb (Takes 15 charges) 
O ~— Throw big slime bomb (Takes 30 charges) 
S — Scan (show where other players are) (Takes 1 charge) 
Cc ~ Cloak (hide from scanners) (Takes 1 charge) 
“L — Redraw screen 
q — Quit — 
Knowing what the symbols on the screen often helps: 

-|+ —walls 
/\. ~ diagonal (deflecting) walls 
# — doors (dispersion walls) 
; — small mine 
2g — large mine 
' — shot 
fe) — grenade 
O ~ satchel charge 

 @ ~~ -—bomb 
s ~ small slime bomb 

$ — big slime bomb 


><“v — you facing right, left, up, or down 
}{i!  — other players facing right, left, up, or down 
* — explosion 
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\|/ 
-—*— —grenade and large mine explosion 
/\\ 


Satchel and bomb explosions are larger than grenades (5x5, 7x7, 
and 3x3 respectively). 


Other helpful hints: 


e You can only fire in the direction you are facing. 

e You can only fire three shots in a row, then the gun must cool. 

e A shot only affects the square it hits. 

e Shots and grenades move 5 times faster than you do. 

e To stab someone, you must face that player and move at them. 

e Stabbing does 2 points worth of damage and shooting does 5 points. 

e Slime does 5 points of damage each time it hits. 

e You start with 15 charges and get 5 more for every new player. 

e A grenade affects the nine squares centered about the square it hits. 

e A Satchel affects the twenty-five squares centered about the square it hits. 

e A bomb affects the forty-nine squares centered about the square it hits. 

e Slime affects all squares it oozes over (15 or 30 respectively). 

e One small mine and one large mine is placed in the maze for every new player. A mine has a 5% proba- 
bility of tripping when you walk directly at it; 50% when going sideways on to it; 95% when backing up 
on to it. Tripping a mine costs you 5 points or 10 points respectively. Defusing a mine is worth 1 charge 
or 9 charges respectively. 

e You cannot see behind you. 

e Scanning lasts for (20 times the number of players) turns. Scanning takes 1 ammo charge, so don’t waste 
all your charges scanning. 

e Cloaking lasts for 20 turns. 

e Whenever you kill someone, you get 2 more damage Capacity points and 2 damage points taken away. 

e Maximum typeahead is 5 characters. 

e A shot destroys normal (i.e., non-diagonal, non-door) walls. 

e Diagonal walls deflect shots and change orientation. 

e Doors disperse shots in random directions (up, down, left, right). 

e Diagonal walls and doors cannot be destroyed by direct shots but may be destroyed by an adjacent 
grenade explosion. 

e Slime goes around walls, not through them. 

e Walls regenerate, reappearing in the order they were destroyed. One percent of the regenerated walls 
will be diagonal walls or doors. When a wall is generated directly beneath a player, he is thrown in a 
random direction for a random period of time. When he lands, he sustains damage (up to 20 percent of 
the amount of damage he had before impact); that is, the less damage he had, the more nimble he is and 
therefore less likely to hurt himself on landing. 

e There is a volcano close to the center of the maze which goes off close to every 100 deaths. 

e The environment variable HUNT is checked to get the player name. If you don’t have this variable set, 
hunt will ask you what name you want to play under. If it is set, you may also set up a single character 
keyboard map, but then you have to enumerate the options: 

e.g. setenv HUNT “‘name=Sneaky,mapkey=zoFfGg1f2g3F4G”’ 
sets the player name to Sneaky, and the maps z to 0, F to f, G to g, 1 tof, ia a and 4 to G. The 
mapkey option must be last. 

e It’s a boring game if you’re the only one playing. 


Your score is the ratio of number of kills to number of times you entered the game and is only kept for the 
. duration of a single session of hunt. 
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Hunt normally drives up the load average to be about (number_of_ players + 0.5) greater than it would be 
without a hunt game executing. A limit of three players per host and nine players total is enforced by 
hunt. 
OPTIONS i 
—m You enter the game as a monitor (you can see the action but you cannot play). 


~q Hunt queries the network and reports if an active games is found. This is useful for login scripts. 


FILES 
/usr/games/lib/hunt.driver game coordinator 

AUTHORS 
Conrad Huang, Ken Amold, and Greg Couch; University of California, San Francisco, Computer Graphics 
Lab . 

ACKNOWLEDGEMENTS 
We thank Don Kneller, John Thomason, Eric Pettersen, and Scott Weiner for providing endless hours of 
play-testing to improve the character of the game. We hope their significant others will forgive them; we 
certainly don’t. 

BUGS 
To keep up the pace, not everything is as realistic as possible. 
There were some bugs in early releases of 4.2 BSD that hunt helped discover. Hunt will crash your sys- 
tem if those bugs haven’t been fixed. 
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NAME 

mille — play Mille Bournes 
SYNOPSIS 

/usr/games/mille [ file } 
DESCRIPTION 

Mille plays a two-handed game reminiscent of the Parker Brother’s game of Mille Bournes with you. The 

tules are described below. If a filename is given on the command line, the game saved in that file is started. 

When a game is started up, the bottom of the score window will contain a list of commands. They are: 

P Pick a card from the deck. This card is placed in the ‘P’ slot in your hand. 

D Discard a card from your hand. To indicate which card, type the number of the card in the hand 

(or ‘‘P’’ for the just-picked card) followed by a <RETURN> or <SPACE>. The <RETURN or 
<SPACE> is required to allow recovery from typos which can be very expensive, like discarding 
safeties. 

U Use acard. The card is again indicated by its number, followed by a <RETURN> or <SPACE>. 

O Toggle ordering the hand. By default off, if turned on it will sort the cards in your hand appropri- 
ately. This is not recommended for the impatient on slow terminals. 

Q Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> (or 

| <RUBOUTS) is equivalent. 

S Save the game in a file. If the game was started from a file, you will be given an opportunity to 
save it on the same file. If you don’t wish to, or you did not start from a file, you will be asked for 
the filename. If you type a <RETURN> without a name, the save will be terminated and the game 

. Tesumed. 

R Redraw the screen from scratch. The command “L (control ‘L’) will also work. 

Ww Toggle window type. This switches the score window between the startup window (with all the 
command names) and the end-of-game window. Using the end-of-game window saves time by 
eliminating the switch at the end of the game to show the final score. Recommended for hackers 
and other miscreants. 

If you make a mistake, an error message will be printed on the last line of the score window, and a bell will 

beep. . 

At the end of each hand or game, you will be asked if you wish to play another. If not, it will ask you if 

you want to save the game. If you do, and the save is unsuccessful, play will be resumed as if you had said 

you wanted to play another hand/game. This allows you to use the ‘‘S’’ command to reattempt the save. 
AUTHOR 

Ken Armold 

(The game itself is a product of Parker Brothers, Inc.) 
SEE ALSO 


curses(3X), Screen Updating and Cursor Movement Optimization: A Library Package , Ken Arnold 


CARDS 
_ Here is some useful information. The number in parentheses after the card name is the number of that card 
in the deck: 
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RULES 


Hazard Repair Safety 

“Out of Gas (2) Gasoline (6) Extra Tank (1) 
Flat Tire (2) Spare Tire (6) Puncture Proof (1) 
Accident (2) Repairs (6) Driving Ace (1) 
Stop (4) Go (14) Right of Way (1) 


Speed Limit (3) End of Limit (6) 


25 — (10), 50 — (10), 75 — (10), 100 — (12), 200 - (4) 


Object: The point of this game is to get a total of 5000 points in several hands. Each hand is a race to put 
down exactly 700 miles before your opponent does. Beyond the points gained by putting down milestones, 
there are several other ways of making points. 


Overview: The game is played with a deck of 101 cards. Distance cards represent a number of miles trav- 
eled. They come in denominations of 25, 50, 75, 100, and 200. When one is played, it adds that many 
miles to the player’s trip so far this hand. Hazard cards are used to prevent your opponent from putting 
down Distance cards. They can only be played if your opponent has a Go card on top of the Battle pile. 
The cards are Out of Gas, Accident, Flat Tire, Speed Limit, and Stop. Remedy cards fix problems caused 
by Hazard cards played on you by your opponent. The cards are Gasoline, Repairs, Spare Tire, End of 
Limit, and Go. Safety cards prevent your opponent from putting specific Hazard cards on you in the first 
place. They are Extra Tank, Driving Ace, Puncture Proof, and Right of Way, and there are only one of 
each in the deck. | 


Board Layout: The board is split into several areas. From top to bottom, they are: SAFETY AREA 
(unlabeled): This is where the safeties will be placed as they are played. HAND: These are the cards in 
your hand. BATTLE: This is the Battle pile. All the Hazard and Remedy Cards are played here, except 
the Speed Limit and End of Limit cards. Only the top card is displayed, as it is the only effective one. 
SPEED: The Speed pile. The Speed Limit and End of Limit cards are played here to control the speed at 
which the player is allowed to put down miles. MILEAGE: Miles are placed here. The total of the 
numbers shown here is the distance traveled so far. 


Play: The first pick alternates between the two players. Each turn usually starts with a pick from the deck. 
The player then plays a card, or if this is not possible or desirable, discards one. Normally, a play or dis- 
card of a single card constitutes a turn. If the card played is a safety, however, the same player takes 
another turn immediately. 


This repeats until one of the players reaches 700 points or the deck runs out. If someone reaches 700, they 
have the option of going for an Extension, which means that the play continues until someone reaches 1000 
miles. 


Hazard and Remedy Cards: Hazard Cards are played on your opponent’s Battle and Speed piles. 
Remedy Cards are used for undoing the effects of your opponent’s nastiness. 


Go (Green Light) must be the top card on your Battle pile for you to play any mileage, unless you have 
played the Right of Way card (see below). | 

Stop is played on your opponent’s Go card to prevent them from playing mileage until they play a Go 
card. 

Speed Limit is played on your opponent’s Speed pile. Until they play an End of Limit they can only 
play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit is played on your Speed pile to nullify a Speed Limit played by your opponent. 

Out of Gas is played on your opponent’s Go card. They must then play a Gasoline card, and then a Go 
card before they can play any more mileage. 

Flat Tire is played on your opponent’s Go card. They must then play a Spare Tire card, and then a Go 
card before they can play any more mileage. 


May 6, 1986 INTEGRATED SOLUTIONS 4.3 BSD | . at 2 


MILLE (6) | UNIX Programmer’s Manual MILLE (6) 


Accident is played on your opponent’s Go card. They must then play a Repairs card, and then a Go 
card before they can play any more mileage. 


Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard cards on you 
for the rest of the hand. It cancels an attack in progress, and always entitles the player to an extra turn. 

Right of Way prevents your opponent from playing both Stop and Speed Limit cards on you. It also acts 
as a permanent Go card for the rest of the hand, so you can play mileage as long as there is not a Hazard 
card on top of your Battle pile. In this case only, your opponent can play Hazard cards directly on a 
Remedy card other than a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 


Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a Right of 
Way in your Safety area and are not stopped by a Hazard Card. They can be played in any combination 
that totals exactly 700 miles, except that you cannot play more than two 200 mile cards in one hand. A 
hand ends whenever one player gets exactly 700 miles or the deck runs out. In that case, play continues 
until neither someone reaches 700, or neither player can use any cards in their hand. If the trip is com- 
pleted after the deck runs out, this is called Delayed Action. 


Coup Fourré: This is a French fencing term for a counter-thrust move as part of a parry to an opponents 
attack. In Mille Bournes, it is used as, follows: If an opponent plays a Hazard card, and you have the 
corresponding Safety in your hand, you play it immediately, even before you draw. This immediately 
removes the Hazard card from your Battle pile, and protects you from that card for the rest of the game. 
This gives you more points (see ‘‘Scoring’’ below). 


Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the trip. The terms 
used in the Score window have the following meanings: 

Milestones Played: Each player scores as many miles as they played before the trip ended. 

Each Safety: 100 points for each safety in the Safety area. 

All 4 Safeties: 300 points if all four safeties are played. 

Each Coup Fouré: 300 points for each Coup Fouré accomplished. 


The following bonus scores can apply only to the winning player. 
Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 
Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 
Delayed Action: 300 points bonus for finishing after the deck was exhausted. 
Extension: 200 points bonus for completing a 1000 mile trip. 
Shut-Out: 500 points bonus for completing the trip before your opponent played any mileage cards. 


Running totals are also kept for the current score for each player for the hand (Hand Total), the game 
(Overall Total), and number of games won (Games). 
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NAME | 
monop — Monopoly game 


SYNOPSIS 
/usr/games/monop [ file ] 


DESCRIPTION 

Monop is reminiscent of the Parker Brother’s game Monopoly, and monitors a game between 1 to 9 users. 
It assumes that players know the rules of Monopoly. The game follows the Monopoly’s standard rules, 
with. the exception that, if a Property goes up for auction and there are only two solvent players, no auction 
is held and the property remains unowned. 


The game, in effect, lends the player money, so it is possible to buy something which you cannot afford. 
_ However, as soon as a person goes into debt, he must ‘fix the problem’’, i.e., make himself solvent, before 
play can continue. If this is not possible, the player’s property reverts to his debtee, either a player or the 
bank. A player can resign at any time to any person or the bank, which puts Ge property, back on the 
board, unowned. 


_ Any time that the response to a question is a string, e.g., a name, place or person, you can type ‘?’ to get a 
list of valid answers. It is not possible to input a negative number, nor is it ever necessary. 


A Summary of Cinna 
quit: quit game: This allows you to quit the game. It asks you if you're sure. 
print: print board: This prints out the current board. The columns have the following meanings 


(column headings are the same for the where, own holdings, and holdings commands): 
Name The first ten characters of the name of the square 
| Own The nwnber of the owner of the property. 
Price The cost of the property (if any) 
Mg This field has a ‘*’ in it if the property is mortgaged 


# If the property is a Utility or Railroad, this is the number of such owned by the owner. 
If the property is land, this is the number of houses on it. 


Rent Current rent on the property. If it is not owned, there is no rent. 
where: where players are: Tells you where all the players are. A ‘*’ indicates the current player. 


own holdings: 
List your own holdings, i i.e., money, get-out-of jail free cards, and property. 


holdings: holdings list: Look at anyone’s holdings. It will ask you whose holdings you wish to look at. 
When you are finished, type ‘“done’’. 


shell: shell escape: Escape to a shell. When the shell dies, the program continues where you left off. 
mortgage: mortgage property: Sets up a list of mortgageable property, and asks which you wish to mort- 
gage. 
unmortgage: 
unmortgage property: Unmortgage mortgaged property. 
buy: buy houses: Sets up a list of monopolies on which you can buy houses. If there is more than 


one, it asks you which you want to buy for. It then asks you how many for each piece of pro- 

-perty, giving the current amount in parentheses after the property name. If you build in an 
unbalanced manner (a disparity of more than one house within the same monopoly), it asks 
you to re-input things. 
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resign: 


save: 


restore: 


roll: 


AUTHOR 
Ken Arnold 


FILES 
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sell houses: Sets up a list of monopolies from which you can sell houses. It operates in an 
analogous manner to buy. 

card for jail: Use a get-out-of-jail-free card to get out of jail. If you’re not in jail, or you don’t 
have one, it tells you so. 


pay for jail: Pay $50 to get out of jail, from whence you are put on Just Visiting. Difficult to 
do if you’re not there. 

This allows you to trade with another player. It asks you whom you wish to trade with, and 
then asks you what each wishes to give up. You can get a summary at the end, and, in all 
Cases, it asks for confirmation of the trade before doing it. 


Resign to another player or the bank. If you resign to the bank, all property reverts to its virgin 
state, and get-out-of-jail free cards revert to the deck. . 


save game: Save the current game in a file for later play. You can continue play after saving, 
either by adding the file in which you saved the game after the monop command, or by using 
the restore command (see below). It will ask you which file you wish to save it in, and, if the 
file exists, confirm that you wish to overwrite it. 


restore game: Read in a previously saved game from a file. It leaves the file intact. 


Roll the dice and move forward to your new location. If you simply hit the <RETURN> key 
instead of a command, it is the same as typing roll. 


/ust/games/lib/cards.pck Chance and Community Chest cards 


BUGS 


No command can be given an argument instead of a response to a query. 
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NAME | . 
number — convert Arabic numerals to English 
SYNOPSIS | | 
/usr/games/number 
DESCRIPTION 


Number copies the standard input to the standard output, changing each decimal number to a fully spelled 
out version. _ 
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NAME 
quiz — test your knowledge 
SYNOPSIS 
/usr/games/quiz [ -i file ] [-t ] [ category] category2 ] 
DESCRIPTION 
Quiz gives associative knowledge tests on various subjects. It asks items chosen from category] and 
expects answers from category2. If no categories are specified, quiz gives instructions and lists the avail- 
able categories. 
Quiz tells a correct answer whenever you type a bare newline. At the end of input, upon interrupt, or when 
questions run out, quiz reports a score and terminates. 
The —t flag specifies ‘tutorial’ mode, where missed questions are repeated later, and material is gradually 
introduced as you learn. 
The —i flag causes the named file to be substituted for the default index file. The lines of these files have 
the syntax: 
line = category newline| category ‘:’ line 
category = alternate| category ‘|’ alternate 
alternate = empty| alternate primary 
primary = character| ‘[’ category ‘]’| option 
option = ‘{’ category ‘}’ 
The first category on each line of an index file names an information file. The remaining categories specify 
the order and contents of the data in each line of the information file. Information files have the same syn- 
tax. Backslash ‘\’ is used as with sh(1) to quote syntactically significant characters or to insert transparent 
newlines into a line. When either a question or its answer is empty, quiz will refrain from asking it. 
FILES 
/ust/games/quiz.k/* 
BUGS 


The construct ‘a| ab’ doesn’t work in an information file. Use ‘a{b}’. 
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NAME 
rain — animated raindrops display 

SYNOPSIS . 
/usr/games/rain 

DESCRIPTION 

Rain’s display is modeled after the VAX/VMS program of the same name. The terminal has to be set for 

9600 baud to obtain the proper effect. 
As with all programs that use termcap, the TERM environment variable must be set (and exported) to the 
type of the terminal being used. 

FILES 
/etc/termcap 


AUTHOR 
Eric P. Scott 
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NAME 


robots — fight off villainous robots 


SYNOPSIS 


/usr/games/robots [ options } [ scorefile ] 


DESCRIPTION 


Robots pits you against evil robots, who are trying to kill you (which is why they are evil). Fortunately for 
you, even though they are evil, they are not very bright and have a habit of bumping into each other, thus 
destroying themselves. In order to survive, you must get them to kill each other off, since you have no 
offensive weaponry. 


Since you are stuck without offensive weaponry, you are endowed with one piece of defensive weaponry: 
a teleportation device. When two robots run into each other or a junk pile, they die. If a robot runs into 
you, you die. When a robot dies, you get 10 points, and when all the robots die, you start on the next field. 
This keeps up until they finally get you. 


Robots are represented on the screen by a ‘+’, the junk heaps from their collisions by a ‘*’, and you (the 
good guy) by a ‘@’. | | 
The commands are: 


move one square left 

move one square right 

move one square up 

move one square down 

move One square up and left 

move one square up and right 
move one square down and left 
move one square down and right 

; (also space) do nothing for one turn 
HJKLBNYU run as far as possible in the given direction 
> do nothing for as long as possible 

t teleport to a random location 

w wait until you die or they all do 

q quit 

“L redraw the screen 


Boe em em 


All commands can be preceded by a count. 
If you use the ‘w’ command and survive to the next level, you will get a bonus of 10% for each robot 


_ which died after you decided to wait. If you die, however, you get nothing. For all other commands, the 


program will save you from typos by stopping short of being eaten. However, with ‘w’ you take the risk of © 
dying by miscalculation. 

Only five scores are allowed per user on the score file. If you make it into the score file, you will be shown 
the list at the end of the game. If an alternate score file is specified, that will be used instead of the standard 
file for scores. 


OPTIONS 


—S Don’t play, just show the score file 


-j Jump, i.e., when you run, don’t show any intermediate positions; only show things at the end. 
This is useful on slow terminals. 


-t Teleport automatically when you have no other option. This is a little disconcerting until you get 
used to it, and then it is very nice. 


-a_—sC AAdivannce into the higher levels directly, skipping the lower, easier levels. 
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AUTHOR 
Ken Arnold 


FILES | | 
/usr/games/lib/robots_roll the score file 


BUGS 
Bugs? You crazy, man?!? 
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NAME 
rogue — Exploring The Dungeons of Doom 
SYNOPSIS 
/usr/games/rogue [ options } [ save_file ] 
DESCRIPTION 
Rogue is a computer fantasy game with a new twist. It is crt oriented and the object of the game is to sur- 


vive the attacks of various monsters and get a lot of gold, rather than the puzzle solving orientation of most 
computer fantasy games. 


To get started you really only need to know two commands. The command ? will give you a list of the 
available commands and the command / will identify the things you see on the screen. 


To win the game (as opposed to merely playing to beat other people’s high scores) you must locate the 
Amulet of Yendor which is somewhere below the 20th level of the dungeon and get it out. Nobody has 
achieved this yet and if somebody does, they will probably go down in history as a hero among heroes. 


When the game ends, either by your death, when you quit, or if you (by some miracle) manage to win, 
rogue will give you a list of the top-ten scorers. The scoring is based entirely upon how much gold you 
get. There is a 10% penalty for getting yourself killed. 


If save_file is specified, rogue will be restored from the specified saved game file. 


OPTIONS 
—r Restores a Saved game. The save game file is presumed to be the default. 


-s Prints out the list of scores. 
—d Kills you and tries to add you to the score file. 
For more detailed directions, read the document A Guide to the Dungeons of Doom. 


AUTHORS 
Michael C. Toy, Kenneth C. R. C. Arnold, Glenn Wichman 


FILES 
/usr/games/lib/rogue_roll Score file 
“/rogue.save Default save file 
SEE ALSO . 
Michael C. Toy and Kenneth C.R.C. Amold, A guide to the Dungeons of Doom 


BUGS 
Probably infinite (although countably infinite). However, that Ice Monsters sometimes transfix you per- 
manently is not a bug. It’s a feature. 
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NAME 


sail — multi-user wooden ships and iron men 


SYNOPSIS 


sail [—s[-1]]{-x][—b] [num] 


DESCRIPTION 


Sail is a computer version of Avalon Hill’s game of fighting sail originally developed by S. Craig Taylor. 


Players of Sail take command of an old fashioned Man of War and fight other players or the computer. 
They may re-enact one of the many historical sea battles recorded in the game, or they can choose a 
fictional battle. 


As a Sea captain in the Sail Navy, the player tis complete control over the workings of his ship. He must 
order every maneuver, change the set of his sails, and judge the right moment to let loose the terrible des- 
truction of his broadsides. In addition to fighting the enemy, he must harness the powers of the wind and 
sea to make them work for him. The outcome of many battles during the age of sail was decided by the 
ability of one captain to hold the ‘weather gage.’ 


The flags are: 
-s Print the names and ships of the top ten sailors. 
-I Show the login name. Only effective with -s. 
-x Play the first available ship instead of prompting for a choice. 
—b No bells. 
IMPLEMENTATION 


Sail is really two programs in one. Each player starts up a process which runs his own ship. In addition, a 
driver process is forked (by the first player) to run the computer ships and take care of global bookkeeping. 


Because the driver must calculate moves for each ship it controls, the more ships the computer is playing, 
the slower the game will appear. 


If a player joins a game in progress, he will synchronize with the other players (a rather slow process for 
everyone), and then he may play along with the rest. 


To implement a multi-user game in Version 7 UNIX, which was the operating system Sail was first written 
under, the communicating processes must use a common temporary file as a place to read and write mes- 
sages. In addition, a locking mechanism must be provided to ensure exclusive access to the shared file. 
For example, Sail uses a temporary file named /tmp/#sailsink.21 for scenario 21, and corresponding 
filenames for the other scenarios. To provide exclusive access to the temporary file, Sail uses a technique 
stolen from an old game called "pubcaves" by Jeff Cohen. Processes do a busy wait in the loop 


for (n = 0; link(sync_file, sync_lock) <0 && n< 30; n++) 
sleep(2); 


until they are able to create a link to a file named "/tmp/#saillock.??". The "??" correspond to the scenario 
number of the game. Since UNIX guarantees that a link will point to only one file, the process that 
succeeds in linking will have exclusive access to the temporary file. 


Whether or not this really works is open to speculation. When ucbmiro was rebooted after a crash, the file 
system check program found 3 links between the Sail temporary file and its link file. 


CONSEQUENCES OF SEPARATE PLAYER AND DRIVER 


When players do something of global interest, such as moving or firing, the driver must coordinate the 
action with the other ships in the game. For example, if a player wants to move in a certain direction, he 
writes a message into the temporary file requesting the driver to move his ship. Each ‘‘turn,’’ the driver 


_ reads all the messages sent from the players and decides what happened. It then writes back into the tem- 


porary file new values of variables, etc. 
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The most noticeable effect this communication has on the game is the delay in moving. Suppose a player 
types a move for his ship and hits return. What happens then? The player process saves up messages to be 
written to the temporary file in a buffer. Every 7 seconds or so, the player process gets exclusive access to 
the temporary file and writes out its buffer to the file. The driver, running asynchronously, must read in the 
movement command, process it, and write out the results. This takes two exclusive accesses to the tem- 
porary file. Finally, when the player process gets around to doing another 7 second update, the results of 
the move are displayed on the screen. Hence, every movement requires four exclusive accesses to the tem- 
porary file (anywhere from 7 to 21 seconds depending upon asynchrony) before the player sees the results 
of his moves. 


In practice, the delays are not as annoying as they would appear. There is room for “pipelining” in the 
movement. After the player writes out a first movement message, a second movement command can then 
be issued. The first message will be in the temporary file waiting for the driver, and the second will be in 
the file buffer waiting to be written to the file. Thus, by always typing moves a turn ahead of the time, the 
player can sail around quite quickly. 


If the player types several movement commands between two 7 second updates, only the last movement 
command typed will be seen by the driver. Movement commands within the same update "overwrite" each 
other, in a sense. 


THE HISTORY OF SAIL ’ : 

I wrote the first version of Sail on a PDP 11/70 in the fall of 1980. Needless to say, the code was horren- 
dous, not portable in any sense of the word, and didn’t work. The program was not very modular and had 
fseeks() and fwrites() every few lines. After a tremendous rewrite from the top down, I got the first work- 
ing version up by 1981. There were several annoying bugs concerning firing broadsides and finding 
angles. Sail uses no floating point, by the way, so the direction routines are rather tricky. Ed Wang 
rewrote my angle() routine in 1981 to be more correct (although it still doesn’t work perfectly), and he 
added code to let a player select which ship he wanted at the start of the game (instead of the first one 
available). 


Captain Happy (Craig Leres) is responsible for making Sail portable for the first time. This was no easy 
task, by the way. Constants like 2 and 10 were very frequent in the code. I also became famous for using 
"Riggle Memorial Structures” in Sail. Many of my structure references are so long that they run off the line 
printer page. Here is an example, if you promise not to laugh. 


specs[scene[fiog.fgamenum].ship[fiog.fshipnum].shipnum].pts 


Sail received its fourth and most thorough rewrite in the summer and fall of 1983. Ed Wang rewrote and 
modularized the code (a monumental feat) almost from scratch. Although he introduced many new bugs, 
the final result was very much cleaner and (?) faster. He added window movement commands and find 
ship commands. 


HISTORICAL INFO 
Old Square Riggers were very maneuverable ships capable of intricate sailing. Their only disadvantage 
was an inability to sail very close to the wind. The design of a wooden ship allowed only for the guns to 
bear to the left and right sides. A few guns of small aspect (usually 6 or 9 pounders) could point forward, 
but their effect was small compared to a 68 gun broadside of 24 or 32 pounders. The guns bear approxi- 
mately like so: 


\ up to a range of ten (for round shot) 
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An interesting phenomenon occurred when a broadside was fired down the length of an enemy ship. The 
shot tended to bounce along the deck and did several times more damage. This phenomenon was called a 
rake. Because the bows of a ship are very strong and present a smaller target than the stern, a stern rake 
(firing from the stern to the bow) causes more damage than a bow rake. 


b 
00 ---- Stern rake! 
a 


Most ships were equipped with carronades, which were very large, close range cannons. American ships 
from the revolution until the War of 1812 were almost entirely armed with carronades. 


The period of history covered in Sail is approximately from the 1770’s until the end of Napoleanic France 
in 1815. There are many excellent books about the age of sail. My favorite author is Captain Frederick 
Marryat. More contemporary authors include C.S. Forester and Alexander Kent. 


Fighting ships came in several sizes classed by armament. The mainstays of any fleet were its "Ships of the 
Line", or "Line of Battle Ships". They were so named because these ships fought together in great lines. 
They were close enough for mutual support, yet every ship could fire both its broadsides. We get the 
modern words "ocean liner,” or “liner,” and “battleship” from "ship of the line." The most common size 
was the the 74 gun two decked Mp of the line. The two gun decks usually mounted 18 and 24 pounder 
guns. 


The pride of the fleet were the first rates. These were huge three decked ships of the line mounting 80 to 
136 guns. The guns in the three tiers were usually 18, 24, and 32 pounders in that order from top to bot- 
tom. 


Various other ships came next. They were almost all "razees,” or ships of the line with one deck sawed off. 
They mounted 40-64 guns and were a poor cross between a frigate and a line of battle ship. They neither 
had the speed of the former nor the firepower of the latter. 


Next came the "eyes of the fleet." Frigates came in many sizes mounting anywhere from 32 to 44 guns. © 
They were very handy vessels. They could outsail anything bigger and outshoot anything smaller. Frigates 
didn’t fight in lines of battle as the much bigger 74’s did. Instead, they harassed the enemy’s rear or cap- 
tured crippled ships. They were much more useful in missions away from the fleet, such as cutting out 
expeditions or boat actions. They could hit hard and get away fast. 


Lastly, there were the corvettes, sloops, and brigs. These were smaller ships mounting typically fewer than 
20 guns. A corvette was only slightly smaller than a frigate, so one might have up to 30 guns. Sloops were 
used for carrying dispatches or passengers. Brigs were something you built for land-locked lakes. 


SAIL PARTICULARS 
Ships in Sail are represented by two characters. One character represents the bow of the ship, and the other 
represents the stern. Ships have nationalities and numbers. The first ship of a nationality is number 0, the 
second number 1, etc. Therefore, the first British ship in a saad would be printed as "bO". The second Brit 
would be "b1", and the fifth Don would be "s4". 


’ Ships can set normal sails, called Battle Sails, or bend on extra canvas called Full Sails. A ship under full 
sail is a beautiful sight indeed, and it can move much faster than a ship under Battle Sails. The only trouble 
is, with full sails set, there is so much tension on sail and rigging that a well aimed round shot can burst a 
sail into ribbons where it would only cause a little hole in a loose sail. For this reason, rigging damage is 
doubled on a ship with full sails set. Don’t let that discourage you from using full sails. I like to keep them 
up right into the heat of battle. A ship with full sails set has a capital letter for its nationality. E.g., a Frog, 
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"“fO", with full sails set would be printed as "FO". 


When a ship is battered into a listing hulk, the last man aboard "strikes the colors." This ceremony is the 
ship’s formal surrender. The nationality character of a surrendered ship is printed as "!". E.g., the Frog of 
our last example would soon be "!0". 


A ship has a random chance of catching fire or sinking when it reaches the stage of listing hulk. A sinking 
ship has a“ printed for its nationality, and a ship on fire and about to explode has a "#" printed. 


Captured ships become the nationality of the prize crew. Therefore, if an American ship captures a British 
ship, the British ship will have an "a" printed for its nationality. In addition, the ship number is changed to 
"&""’", "C’, .")", "*", or "+" depending upon the original number, be it 0,1,2,3,4, or 5. E.g., the "bO" cap- 
tured by an American becomes the "a&". The "s4" captured by a Frog becomes the "f*". 


The ultimate example is, of course, an exploding Brit captured by an American: "#&". 


MOVEMENT 
Movement i is the most st confusing part of Sail to many. Ships can head in 8 directions: 


b b0 b b b Ob Ob 
0 0 0 
The stern of a ship moves when it turns. The bow remains stationary. Ships can always turn, regardless of 
the wind (unless they are becalmed). All ships drift when they lose headway. If a ship doesn’t move for- 


ward at all for two turns, it will begin to drift. If a ship has begun to drift, then it must move forward 
before it turns, if it plans to do more than make a right or left tum, which is always possible. 


Movement commands to Sail are a string of forward moves and turns. An example is "13". It will tum a 
ship left and then move it ahead 3 spaces. In the drawing above, the "bO" made 7 successive left turns. 
When Sail prompts you for a move, it prints three characters of import. E.g., 
move (7, 4): 

The first number is the maximum number of moves you can make, including tums. The second number is 
the maximum number of turns you can make. Between the numbers is sometimes printed a quote "’". If 
the quote is present, it means that your ship has been drifting, and you must move ahead to regain headway 
before you turn (see note above). Some of the possible moves for the example above are as follows: 


move (7, 4): 7 

move (7, 4): 1 

move (7, 4): d /* drift, or do nothing */ 
move (7, 4): 6r 

move (7, 4): 5rl 

move (7, 4): 4rir 

move (7, 4): lirir2 

move (7, 4): irlrirl 


Because square riggers performed so poorly sailing into the wind, if at any point in a movement command 
7 turn into the wind, the movement stops there. E.g., 


move (7, 4): 1114 
Movement Error; 
Helm: 111 


Moreover, whenever you make a turn, your movement allowance drops to min(what’s left, what you would 


have at the new attitude). In short, if you turn closer to the wind, you most likely won’t be able to sail the 
full allowance printed in the "move" prompt. 
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Old sailing captains had to keep an eye constantly on the wind. Captains in Sail are no different. A ship’s 
ability to move depends on its attitide to the wind. The best angle possible is to have the wind off your 
quarter, that is, just off the stern. The direction rose on the side of the screen gives the possible movements 
for your ship at all positions to the wind. Battle sail speeds are given first, and full sail speeds are given in 
ee. 


Pretend the bow of your ship (the "*") is pointing upward and the wind is blowing from the bottom to the 
top of the page. The numbers at the bottom "3(6)" will be your speed under battle or full sails in such a 
Situation. If the wind is off your quarter, then you can move "4(7)". If the wind is off your beam, "3(6)". 
If the wind is off your bow, then you can only move "1(2)". Facing into the wind, you can’t move at all. 
Ships facing into the wind were said to be "in irons”. 


WINDSPEED AND DIRECTION 
The windspeed and direction is displayed as a little weather vane on the side of the screen. The number in 
the middle of the vane indicates the wind speed, and the + to - indicates the wind direction. The wind 
blows from the + sign (high pressure) to the - sign (low pressure). E.g., 


| 
3. 


+ 


The wind speeds are 0 = becalmed, 1 = light breeze, 2 = moderate breeze, 3 = fresh breeze, 4 = strong 
breeze, 5 = gale, 6 = full gale, 7 = hurricane. If a hurricane shows up, all ships are destroyed. . 
GRAPPLING AND FOULING 
If two ships collide, they run the risk of becoming tangled together. This is called "fouling." Fouled ships 
are stuck together, and neither can move. They can unfoul each other if they want to. Boarding parties can 
only be sent across to ships when the antagonists are either fouled or grappled. 


Ships can grapple each other by throwing grapnels into the rigging of the other. 
The number of fouls and grapples you have are displayed on the upper right of the screen. 
BOARDING 
Boarding was a very costly venture in terms of human life. Boarding parties may be formed in Sail to 


either board an enemy ship or to defend your own ship against attack. Men organized as Defensive Board- 
ing Parties fight twice as hard to save their ship as men left unorganized. 


The boarding strength of a crew depends upon its quality and upon the number of men sent. 


CREW QUALITY 
The British seaman was world renowned for his sailing abilities. American sailors however, were actually 
the best seamen in the world. Because the American Navy offered twice the wages of the Royal Navy, 
British seamen who liked the sea defected to America by the thousands. 


In Sail, crew quality is quantized into 5 energy levels. "Elite" crews can outshoot and outfight all other 
sailors. "Crack" crews are next. "Mundane" crews are average, and "Green" and "Mutinous” crews are 
below average. A good rule of thumb is that "Crack" or "Elite" crews get one extra hit per broadside com- 
pared to "Mundane” crews. Don’t expect too much from "Green" crews. 
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BROADSIDES 
Your two broadsides may be loaded with four kinds of shot: grape, chain, round, and double. You have 
guns and carronades in both the port and starboard batteries. Carronades only have a range of two, so you 
have to get in close to be able to fire them. You have the choice of firing at the hull or rigging of another 
ship. If the range of the ship is greater than 6, then you may only shoot at the rigging. 


The types of shot and their advantages are: 


ROUND 
Range of 10. Good for hull or rigging hits. 


DOUBLE 
Range of 1. Extra good for hull or rigging hits. Double takes two turns to load. 


CHAIN 
Range of 3. Excellent for tearing down rigging. Cannot damage hull or guns, though. 


GRAPE 
Range of 1. Sometimes devastating against enemy crews. 


On the side of the screen is displayed some vital information about your ship: 


Load D! R! 
: Hull 9 
Crew 4 4 2 
Guns 4 4 
Carr 2 2 
Rigg 5555 


"Load" shows what your port (left) and starboard (right) broadsides are loaded with. A "!" after the type of 
shot indicates that it is an initial broadside. Initial broadside were loaded with care before battle and before 
the decks ran red with blood. As a consequence, initial broadsides are a little more effective than broad- 
sides loaded later. A "*" after the type of shot indicates that the gun crews are still loading it, and you can- 
not fire yet. "Hull" shows how much hull you have left. "Crew" shows your three sections of crew. As 
your crew dies off, your ability to fire decreases. "Guns" and "Carr" show your port and starboard guns. 
As you lose guns, your ability to fire decreases. “Rigg” shows how much rigging you have on your 3 or 4 
masts. As rigging is shot away, you lose mobility. 


EFFECTIVENESS OF FIRE 

It is very dramatic when a ship fires its thunderous broadsides, but the mere opportunity to fire them does 
not guarantee any hits. Many factors influence the destructive force of a broadside. First of all, and the 
Chief factor, is distance. It is harder to hit a ship at range ten than it is to hit one sloshing alongside. Next 
is raking. Raking fire, as mentioned before, can sometimes dismast a ship at range ten. Next, crew size 
and quality affects the damage done by a broadside. The number of guns firing also bears on the point, so 
to speak. Lastly, weather affects the accuracy of a broadside. If the seas are high (5 or 6), then the lower 
gunports of ships of the line can’t even be opened to run out the guns. This gives frigates and other flush 
decked vessels an advantage in a storm. The scenario Pellew vs. The Droits de L’Homme takes advantage 
of this peculiar circumstance. 


REPAIRS 
Repairs may be made to your Hull, Guns, and Rigging at the slow rate of two points per three turns. The © 
message "Repairs Completed” will be printed if no more repairs can be made. 

PECULIARITIES OF COMPUTER SHIPS 
Computer ships in Sail follow all the rules above with a few exceptions. Computer ships never repair dam- 
age. If they did, the players could never beat them. They play well enough as it is. As a consolation, the 
computer ships can fire double shot every turn. That fluke is a good reason to keep your distance. The 
Driver figures out the moves of the computer ships. It computes them with a typical A.I. distance function 
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and a depth first search to find the maximum “score.” It seems to work fairly well, although Ill be the first 
to admit it isn’t perfect. 


HOW TO PLAY 
Commands are given to Sail by typing a single character. You will then be prompted for further input. A 
brief summary of the commands follows. 
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COMMAND SUMMARY 

’f’ Fire broadsides if they bear 

"l Reload 

"L’ Unload broadsides (to change ammo) 
*m’ Move 

i’ Print the closest ship 

"T’ Print all ships 

’F’ Find a particular ship or ships (e.g. "a?" for all Americans) 
*s’ Send a message around the fleet 

*b’ Attempt to board an enemy ship 

*B’ Recall boarding parties 

’c’ Change set of sail 

’r’ Repair 

’u’ Attempt to unfoul 

’g’ Grapple/ungrapple 

*v’ Print version number of game 
**L’ Redraw screen 


QQ’ Quit 


’C’ _—_‘ Center your ship in the window 

U’ Move window up 

*D’,’N’ Move window down 

"H’ Move window left 

“y’ Move window right 

’S’ _ Toggle window to follow your ship or stay where it is 


SCENARIOS 
Here is a summary of the scenarios in Sail: 


Ranger vs. Drake: 
Wind from the N, blowing a fresh breeze. 


(a) Ranger 19 gun Sloop (crack crew) (7 pts) 
(b) Drake 17 gun Sloop (crack crew) (6 pts) 


The Battle of Flamborough Head: 
Wind from the S, blowing a fresh breeze. 


This is John Paul Jones’ first famous battle. Aboard the Bonhomme Richard, he was able to overcome the 
Serapis’s greater firepower by quickly boarding her. 


(a) Bonhomme Rich 42 gun Corvette (crack crew) (11 pts) 
(b) Serapis 44 gun Frigate (crack crew) (12 pts) 


Arbuthnot and Des Touches: 
Wind from the N, blowing a gale. 


(b) America 64 gun Ship of the Line (crack crew) (20 pts) 
(b) Befford 74 gun Ship of the Line (crack crew) (26 pts) 
(b) Adamant 50 gun Ship of the Line (crack crew) (17 pts) 
(b) London 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Royal Oak 74 gun Ship of the Line (crack crew) (26 pts) 
(f) Neptune 74 gun Ship of the Line (average crew) (24 pts) 
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(f) Duc Bougogne 80 gun 3 Decker SOL (average crew) (27 pts) 
(f) Conquerant 74 gun Ship of the Line (average crew) (24 pts) 
(f) Provence 64 gun Ship of the Line (average crew) (18 pts) 
(f) Romulus | 44 gun Ship of the Line (average crew) (10 pts) 


Suffren and Hughes: 
Wind from the S, blowing a fresh breeze. 


(b) Monmouth 74 gun Ship of the Line (average crew) (24 pts) 
(b) Hero 74 gun Ship of the Line (crack crew) (26 pts) — 
(b) Isis 50 gun Ship of the Line (crack crew) (17 pts) 

(b) Superb 74 gun Ship of the Line (crack crew) (27 pts) 

(b) Burford 74 gun Ship of the Line (average crew) (24 pts) 
(f) Flamband 50 gun Ship of the Line (average crew) (14 pts) 
(f) Annibal 74 gun Ship of the Line (average crew) (24 pts) 
(f) Severe 64 gun Ship of the Line (average crew) (18 pts) 

(f) Brilliant 80 gun Ship of the Line (crack crew) (31 pts) 

(f) Sphinx 80 gun Ship of the Line (average crew) (27 pts) 


Nymphe vs. Cleopatre: 
Wind from the S, blowing a fresh breeze. 


_(b)Nymphe = 36 gun Frigate (crack crew) (11 pts) 
(f) Cleopatre 36 gun Frigate (average crew) (10 pts) 
Mars vs. Hercule: 
Wind from the S, blowing a fresh breeze. 
(b) Mars 74 gun Ship of the Line (crack crew) (26 pts) 
(f) Hercule 74 gun Ship of the Line (average crew) (23 pts) 


Ambuscade vs. Baionnaise: 
Wind from the N, blowing a fresh breeze. 


(b) Ambuscade 32 gun Frigate (average crew) (9 pts) 

(f) Baionnaise 24 gun Corvette (average crew) (9 pts) 
Constellation vs. Insurgent: : 

Wind from the S, blowing a gale. 


(a) Constellation 38 gun Corvette (elite crew) {17 pts) 
(f) Insurgent 36 gun Corvette (average crew) (11 pts) 


Constellation vs. Vengeance: 
. Wind from the S, blowing a fresh breeze. 


(a) Constellation 38 gun Corvette (elite crew) (17 pts) 
(f) Vengeance 40 gun Frigate (average crew) (15 pts) 


The Battle of Lissa: 
Wind from the S, blowing a fresh breeze. 


(b) Amphion 32 gun Frigate (elite crew) (13 pts) 
(b) Active 38 gun Frigate (elite crew) (18 pts) 
(b) Volage 22 gun Frigate (elite crew) (11 pts) 
_(b) Cerberus = 32 gun Frigate (elite crew) (13 pts) 
(f) Favorite 40 gun Frigate (average crew) (15 pts) 
(f) Flore 40 gun Frigate (average crew) (15 pts) 
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(f) Danae 40 gun Frigate (crack crew) (17 pts) 

(f) Bellona 32 gun Frigate (green crew) (9 pts) 

(f) Corona 40 gun Frigate (green crew) (12 pts) 

(f) Carolina 32 gun Frigate (green crew) (7 pts) 
Constitution vs. Guerriere: 

Wind from the SW, blowing a gale. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) 

(b) Guerriere 38 gun Frigate (crack crew) (15 pts) 
United States vs. Macedonian: 

Wind from the S, blowing a fresh breeze. 


(a) United States 44 gun Frigate (elite crew) (24 pts) 
(b) Macedonian 38 gun Frigate (crack crew) (16 pts) 
— Constitution vs. Java: 

Wind from the S, blowing a fresh breeze. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) 
(b) Java 38 gun Corvette (crack crew) (19 pts) 


Chesapeake vs. Shannon: 
Wind from the S, blowing a fresh breeze. 


(a) Chesapeake 38 gun Frigate (average crew) (14 pts) 
(b) Shannon 38 gun Frigate (elite crew) (17 pts) 

The Battle of Lake Erie: 
Wind from the S, blowing a light breeze. 


(a) Lawrence 20 gun Sloop (crack crew) (9 pts) 
(a) Niagara 20 gun Sloop (elite crew) (12 pts) 
(b) Lady Prevost 13 gun Brig (crack crew) (5 pts) 
(b) Detroit 19 gun Sloop (crack crew) (7 pts) 
(b) Q. Charlotte 17 gun Sloop (crack crew) (6 pts) 


Wasp vs. Reindeer: 
Wind from the S, blowing a light breeze. 


(a) Wasp 20 gun Sloop (elite crew) (12 pts) 

(b) Reindeer 18 gun Sloop (elite crew) (9 pts) 
Constitution vs. Cyane and Levant: 

Wind from the S, blowing a moderate breeze. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) (b) Cyane 
pts) (b) Levant 20 gun Sloop (crack crew) (10 pts) 
Pellew vs. Droits de L’Homme: 


Wind from the N, blowing a gale. 


(b) Indefatigable 44 gun Frigate (elite crew) (14 pts) 
(b) Amazon 36 gun Frigate (crack crew) (14 pts) 
(f) Droits L’Hom 74 gun Ship of the Line (average crew) (24 pts) 
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Algeciras: . . 
Wind from the SW, blowing a moderate breeze. 


(b) Caesar 80 gun Ship of the Line (crack crew) (31 pts) 

(b) Pompee 74 gun Ship of the Line (crack crew) (27 pts) 
(b) Spencer 74 gun Ship of the Line (crack crew) (26 pts) 

(b) Hannibal 98 gun 3 Decker SOL (crack crew) (28 pts) 

(s) Real-Carlos 112 gun 3 Decker SOL (green crew) (27 pts) 
(s)San Fernando 96 gun 3 Decker SOL (green crew) (24 pts) 
(s) Argonauta 80 gun Ship of the Line (green crew) (23 pts) 
(s) San Augustine 74 gun Ship of the Line (green crew) (20 pts) 
(f) Indomptable —_ 80 gun Ship of the Line (average crew) (27 pts) 
(f) Desaix 74 gun Ship of the Line (average crew) (24 pts) 


Lake Champlain: 
Wind from the N, blowing a fresh breeze. 


(a) Saratoga 26 gun Sloop (crack crew) (12 pts) 


(a) Eagle 20 gun Sloop (crack crew) (11 pts) 
(a) Ticonderoga 17 gun Sloop (crack crew) (9 pts) 
(a) Preble 7 gun Brig (crack crew) (4 pts) 

(b) Confiance 37 gun Frigate (crack crew) (14 pts) 
(b) Linnet 16 gun Sloop (elite crew) (10 pts) 

(b) Chubb 11 gun Brig (crack crew) (5 pts) 


Last Voyage of the USS President: 
Wind from the N, blowing a fresh breeze. 


(a) President 44 gun Frigate (elite crew) (24 pts) 
(b) Endymion 40 gun Frigate (crack crew) (17 pts) 
(b) Pomone 44 gun Frigate (crack crew) (20 pts) 
(b) Tenedos 38 gun Frigate (crack crew) (15 pts) 


Hornblower and the Natividad: 
Wind from the E, blowing a gale. 


SAIL (6) 


A scenario for you Homy fans. Remember, he sank the Natividad against heavy odds and winds. Hint: 


don’t try to board the Natividad, her crew is much bigger, albeit green. 
(b) Lydia 36 gun Frigate (elite crew) (13 pts) 
(s) Natividad 50 gun Ship of the Line (green crew) (14 pts) 


Curse of the Flying Dutchman: 
Wind from the S, blowing a fresh breeze. 


Just for fun, take the Piece of cake. 


(s) Piece of Cake 24 gun Corvette (average crew) (9 pts) 
(f) Flying Dutchy 120 gun 3 Decker SOL (elite crew) (43 pts) 


The South Pacific: . 
Wind from the S, blowing a strong breeze. 


(a) USS Scurvy 136 gun 3 Decker SOL (mutinous crew) (27 pts) 
(b) HMS Tahiti 120 gun 3 Decker SOL (elite crew) (43 pts) 
(s) Australian 32 gun Frigate (average crew) (9 pts) 
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(f) Bikini Atoll 7 gun Brig (crack crew) (4 pts) 


Hornblower and the battle of Rosas 
Wind from the E, blowing a fresh breeze. 


The only battle Hornblower ever lost. He was able to dismast one 
ship and stern rake the others though. See if you can do as well. 


(b) Sutherland 74 gun Ship of the Line (crack crew) (26 pts) 
(f) Turenne 80 gun 3 Decker SOL (average crew) (27 pts) 
(f) Nightmare 74 gun Ship of the Line (average crew) (24 pts) 


(f) Paris 112 gun 3 Decker SOL (green crew) (27 pts) 
(f) Napolean 74 gun Ship of the Line (green crew) (20 pts) 
Cape Horn: 


Wind from the NE, blowing a strong breeze. 


(a) Concord 80 gun Ship of the Line (average crew) (27 pts) 
(a) Berkeley 98 gun 3 Decker SOL (crack crew) (28 pts) 


(b) Thames 120 gun 3 Decker SOL (elite crew) (43 pts) 
(s) Madrid 112 gun 3 Decker SOL (green crew) (27 pts) 
(f) Musket 80 gun 3 Decker SOL (average crew) (27 pts) 


New Orleans: 
Wind from the SE, blowing a fresh breeze. 


Watch that little Cypress go! 


(a) Alligator 120 gun 3 Decker SOL (lite crew) (43 pts) 
(b) Firefly 74 gun Ship of the Line (crack crew) (27 pts) 
(b) Cypress 44 gun Frigate (elite crew) (14 pts) 

Botany Bay: 
Wind from the N, blowing a fresh breeze. 


(b) Shark 64 gun Ship of the Line (average crew) (18 pts) 
(f) Coral Snake 44 gun Corvette (elite crew) (24 pts) 
(f) Sea Lion - 44 gun Frigate (elite crew) (24 pts) 
Voyage to the Bottom of the 
Wind from the NW, blowing a fresh breeze. 


This one is dedicated to Richard Basehart and David Hedison. 


(a) Seaview 120 gun 3 Decker SOL (elite crew) (43 pts) 

(a) Flying Sub 40 gun Frigate (crack crew) (17 pts) 

(b) Mermaid 136 gun 3 Decker SOL (mutinous crew) (27 pts) 
(s) Giant Squid 112 gun 3 Decker SOL (green crew) (27 pts) 


Frigate Action: 
Wind from the E, blowing a fresh breeze. 


(a) Killdeer 40 gun Frigate (average crew) (15 pts) 
(b) Sandpiper 40 gun Frigate (average crew) (15 pts) 
(s) Curlew 38 gun Frigate (crack crew) (16 pts) 
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The Battle of Midway: 
Wind from the E, blowing a moderate breeze. 


(a) Enterprise 80 gun Ship of the Line (crack crew) (31 pts) 
(a) Yorktown 80 gun Ship of the Line (average crew) (27 pts) 
(a) Hornet 74 gun Ship of the Line (average crew) (24 pts) 


(j) Akagi 112 gun 3 Decker SOL (green crew) (27 pts) 

(j) Kaga 96 gun 3 Decker SOL (green crew) (24 pts) 

(j)Soryu — —-80 gun Ship of the Line (green crew) (23 pts) 
Star Trek: 


Wind from the S, blowing a fresh breeze. 


(a) Enterprise 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Yorktown 450 gun Ship of the Line (elite crew) (75 pts) 
(a) Reliant 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Galileo 450 gun Ship of the Line (elite crew) (75 pts) 

(k) Kobayashi Maru 450 gun Ship of the Line (elite crew) (75 pts) 
(k) Klingon IT 450 gun Ship of the Line (elite crew) (75 pts) 

(0) Red Orion 450 gun Ship of the Line (elite crew) (75 pts) 
(o) Blue Orion 450 gun Ship of the Line (elite crew) (75 pts) 


CONCLUSION 
Sail has been a group effort. 


Ken Arnold Code 
curses library (pu!) 


AUTHOR 
Dave Riggle 


CO-AUTHOR 
Ed Wang 
REFITTING 
Craig Leres 
CONSULTANTS 
Chris Guthrie 
Captain Happy 
Horatio Nelson 
Nancy Reagan 
and many valiant others... 
REFERENCES 
Wooden Ships & Iron Men, by Avalon Hill 
Captain Horatio Hornblower Novels, (13 of them) by C.S. Forester 
Captain Richard Bolitho Novels, (12 of them). by Alexander Kent 


The Complete Works of Captain Frederick Marryat, (about 20) especially 


Mr. Midshipman Easy 
Peter Simple 
Jacob Faithful 
Japhet in Search of a Father 
_ Snarleyyow, or The Dog Fiend 
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Frank Mildmay, or The Naval Officer 


SEE ALSO 
midway(PUBLIC) 


BUGS 
Probably a few, and please report them to "riggle@ernie" and "“edward@arpa.” 
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NAME | 


snake, snscore — display chase oe 


SYNOPSIS 


/usr/games/snake [—-wa ][-n] 
/usr/games/snscore 


DESCRIPTION 


FILES 


BUGS 


Snake is a display-based game which must be played on a CRT terminal from among those supported by 
vi(1). The object of the game is to make as much money as possible without getting eaten by the snake. 
The —1 and —w options allow you to specify the length and width of the field. By default the entire screen 
(except for the last column) is used. 


You are represented on the screen by an I. The snake is 6 squares long and is represented by S’s. The 
money is $, and an exit is #. Your score is posted in the upper left hand corner. 


You can move around using the same conventions as vi(1), the h, j, k, and 1 keys work, as do the arrow 
keys. Other possibilities include: 


sefc These keys are like hjkl but form a directed pad around the d key. 


HJKL These keys move you all the way in the indicated direction to the same row or column as the 


money. This does not let you jump away from the snake, but rather saves you from having to type 
a key repeatedly. The snake still gets all his turns. 


SEFC Likewise for the upper case versions on the left. 


ATPB_ These keys move you to the four edges of the screen. Their position on the keyboard is the 
mnemonic, e.g. P is at the far right of the keyboard. 


x This lets you quit the game at any time. 

p Points in a direction you might want to go. 

Ww Space warp to get out of tight squeezes, at a price. 

! | Shell escape 

oh Suspend the snake game, on systems which support it. Otherwise an interactive shell is started up. 


To earn money, move to the same square the money is on. A new §$ will appear when you earn the current 
one. As you get richer, the snake gets hungrier. To leave the game, move to the exit (#). 


A record is kept of the personal best score of each player. Scores are only counted if you leave at the exit, 
getting eaten by the snake is worth nothing. 


As in pinball, matching the last digit of your score to the number which appears after the game is worth a 
bonus. 


To see who wastes time playing snake, run /usr! games/snscore . 


/usr/games/lib/snakerawscores database of personal bests 
/ust/games/lib/snake.log log of games played 
/ust/games/busy program to determine if system too busy 


When playing on a small screen, it’s hard to tell when you hit the edge of the screen. 


The scoring function takes into account the size of the screen. A perfect function to do this equitably has 
not been devised. 
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NAME 
trek — trekkie game 
SYNOPSIS 
/usr/games/trek [ [ —a ] file ] 
DESCRIPTION 
Trek is a game of space glory and war. Below is a summary of commands. For complete documentation, 
see Trek by Eric Allman. 
If a filename is given, a log of the game is written onto that file. If the —a flag is given before the filename, 
that file is appended to, not truncated. 
The game will ask you what length game you would like. Valid responses are ‘‘short’’, ‘‘medium’’, and 
*“long’’. You may also type ‘‘restart’’, which restarts a previously saved game. You will then be 
prompted for the skill, to which you must respond ‘‘novice’’, “‘fair’’, ‘“good’’, ‘‘expert’’, ‘“commadore’’, 
or “‘impossible’’. You should normally start out with a novice and work up. 
In general, throughout the game, if you forget what is appropriate the game will tell you what it expects if 
you just type in a question mark. 
AUTHOR 
Eric Allman 
SEE ALSO 
/usr/doc/trek 
COMMAND SUMMARY 
abandon capture 
cloak up/down 
computer request; ... damages 
destruct dock 
help impulse course distance 
Irscan move course distance 


phasers automatic amount 
phasers manual amt! coursel spread! ... 
torpedo course [yes] angle/no 


ram course distance rest time 

shell shields up/down 
srscan [yes/no} 

status terminate yes/no 
undock visual course 
warp warp_factor 
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NAME 
worm — Play the growing worm game 

SYNOPSIS . 
/usr/games/worm [ size ] 

DESCRIPTION | 
In worm, you are a little worm, your body is the "o"’s on the screen and your head is the "@". You move 
with the hjkl keys (as in the game snake). If you don’t press any keys, you continue in the direction you 
last moved. The upper case HJKL keys move you as if you had pressed several (9 for HL and 5 for JK) of 
the corresponding lower case key (unless you run into a digit, then it stops). 
On the screen you will see a digit, if your worm eats the digit is will grow longer, the actual amount longer 

- depends on which digit it was that you ate. The object of the game is to see how long you can make the 

worm grow. 


The game ends when the worm runs into either the sides of the screen, or itself. The current score (how 
much the worm has grown) is kept in the upper left comer of the screen. 


The optional argument, if present, is the initial length of the worm. 


BUGS 
If the initial length of the worm is set to less than one or more than 75, various strange things happen. 
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NAME 
worms — animate worms on a display terminal 


SYNOPSIS 
/usr/games/worms [ —field ] { —length # ] [—number #] [—trail ] 


DESCRIPTION 
Brian Horn (cithep!bdh) showed me a TOPS-20 program on the DEC-2136 machine called WORM, and 
suggested that I write a similar program that would run under Unix. I did, and no apologies. 


—field makes a "field" for the worm(s) to eat; —trail causes each worm to leave a trail behind it. You can 
figure out the rest by yourself. 


FILES 
/etc/termcap 


AUTHOR 
Eric P. Scott 


SEE ALSO 
Snails, by Karl Heuer 


BUGS 
The lower-right-hand character position will not be updated properly on a terminal that wraps at the right 
margin. 


Terminal initialization is not performed. 


May 20, 1985 INTEGRATED SOLUTIONS 4.3 BSD 1 


WUMP(6) UNIX Programmer’s Manual WUMP (6) 


NAME 
wump — the game of hunt-the-wumpus _ 

SYNOPSIS | 
/usr/games/wump 

DESCRIPTION : 
Wump plays the game of ‘Hunt the Wumpus.’. A Wumpus is a creature that lives in a cave with several 

-Tooms connected by tunnels. You wander among the rooms, trying to shoot the Wumpus with an arrow, 

meanwhile avoiding being eaten by the Wumpus and falling into Bottomless Pits. There are also Super 
Bats which are likely to pick you up and drop you in some random room. 
The program asks various questions which you answer one per line; it will give a more detailed description 
if you want. 


This program is based on one described in People’s Computer Company, 2, 2 (November 1973). 
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NAME 
zork — the game of dungeon 

SYNOPSIS 
/usr/games/zork 

DESCRIPTION 
Dungeon is a computer fantasy simulation based on Adventure and on Dungeons & Dragons, originally 
written by Lebling, Blank, and Anderson of MIT. In it you explore a dungeon made up of various rooms, 
Caves, rivers, and so on. The object of the game is to collect as much treasure as possible and stow it safely 
in the trophy case (and, of course, to stay alive.) 
Figuring out the rules is part of the game, but if you are stuck, you should start off with ‘‘open mailbox’’, 
*‘take leaflet’, and then ‘‘read leaflet’’. Additional useful commands that are not documented include: 
quit (to end the game) 
'cmd (the usual shell escape convention) 
> (to save a game) 
< (to restore a game) 

FILES 
/usr/games/lib/d* 
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NAME 
miscellaneous — miscellaneous useful information pages 
DESCRIPTION 
This section contains miscellaneous documentation, mostly in the area of text processing macro packages 
for troff(1). 
ascii map of ASCII character set 
environ user environment 
eqnchar special character definitions for eqn 
hier file system hierarchy 
mailaddr mail addressing description 
man macros to typeset manual pages 
me macros for formatting papers 
ms macros for formatting manuscripts 
term conventional names for terminals 
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Ascii is a map of the ASCII character set, to be printed as needed. It contains: 


NAME 
ascii — map of ASCII character set 

SYNOPSIS 

cat /usr/pub/ascii 

DESCRIPTION 
1000 nul {001 soh|002 stx|003 
1010 bs ]011 ht |012 nl {013 
{020 dle]021 dc1{022 dc2|023 
1030 can|031 em [032 sub/033 
[040 sp {041 ! |042 " |043 
1050 ( {051 ) |052 * [053 
}060 O [061 1 [062 2 |063 
1070 8 {071 9 |072 : {073 
{100 @ {4101 A {102 B {103 
1110 H {111 I [112 J 4113 
1120 P J121 Q {122 R {123 
1130 X {131 Y {132 Z 4133 
1140 ~ {141 a {142 b |143 
1150 h {151 i [152 j 1153 
1160 p 1161 q |162 r {163 
1170 x {171 y [172 2z [173 
| OO nul] 01 soh| 02 stxj| 03 
| 08 bs | 09 ht | Oa ni | Ob 
| 10 dle| 11 dcl| 12 dc2| 13 
| 18 can] 19 em | la sub] 1b 
| 20 sp | 21 ! | 22 " | 23 
{ 28 ( | 29 ) {| 2a * {| 2b 
| 30 O| 31 1 {| 32. 2 | 33 
|} 38 8 | 39 9 | 3a : | 3b 
| 40 @| 41 Al 42 BI 43 
| 48 H| 49 I | 4a J | 4b 
| 50 P|! S51 Q{ 52 R| 53 
| 58 X | 59 Y {| Sa Z{ 5b 
|} 60 ~*~ | 61 a] 62 b | 63 
| 68 h { 69 i | 6a j | 6b 
170 p{71q{{72 r | 73 
| 78 x | 79 y | 7a z{ 7b 

FILES 

— fust/pub/ascii 
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etx|004 eot|005 
vt [014 np [015 
dc3|024 dc4|025 


esc |034 
# |044 
{054 
|064 
|074 
| 104 
1114 
}124 
| 134 
{144 
{154 
| 164 
}174 


wu + 


man rama DWO-- 


etx| 
vet | 
dc3| 
esc| 

# | 


ww + 


naw KORA KQ-: 


| 
| 
| 
| 
| 
| 54 
| 
| 
| 
| 
| 


[035 
{045 
{055 
|065 
|075 
| 105 
}115 
| 125 
135 
1145 


enq | 006 
cr |016 
nak |026 
gs |036 
% |046 
— |056 
5 |066 
= |076 
E |106 
M |116 
U [126 
] 1136 
e |146 


ack|007 
so {017 
syn|027 
rs |037 
& |047 
{057 
| 067 
1077 
}107 
1117 
{127 
{137 
1147 


isc Bm oS Amv an- 


r< Bm ot BManiva- 
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environ — user environment 


SYNOPSIS 


extern char **environ; 


DESCRIPTION 


An array of strings called the ‘environment’ is made available by execve(2) when a process begins. By 
convention these strings have the form ‘name=value’. The following names are used by various com- 


mands: 
PATH 


EXINIT 
USER 


The sequence of directory prefixes that sh, time, nice(1), etc., apply in searching for a file 
known by an incomplete path name. The prefixes are separated by ‘:’. Login(1) sets 
PATH=:/usr/ucb:/bin:/usr/bin. 


A user’s login directory, set by login(1) from the password file passwd(5). 


The kind of terminal for which output is to be prepared. This information is used by com- 
mands, such as nroff or plot(1G), which may exploit special terminal capabilities. See 
/etc/termcap (termcap(5)) for a list of terminal types. 


The filename of the user’s login shell. 


The string describing the terminal in TERM, or the name of the termcap file, see 
termcap(5),termcap(3X). 


A startup list of commands read by ex(1), edit(1), and vi(1). 
The login name of the user. | 


PRINTER The name of the default printer to be used by Ipr(1), Ipq(1), and Iprm(1). 


Further names may be placed in the environment by the export command and ‘name=value’ arguments in 
sh(1), or by the setenv command if you use csh(1). Arguments may also be placed in the environment at 
the point of an execve(2). It is unwise to conflict with certain sh(1) variables that are frequently exported 
by ‘.profile’ files: MAIL, PS1, PS2, IFS. 


SEE ALSO 


csh(1), ex(1), login(1), sh(1), execve(2), system(3), termcap(3X), termcap(5) 
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NAME 
eqnchar — special character definitions for eqn 


SYNOPSIS 
eqn /usr/pub/eqnchar [ files } | troff [ options ] 
negn /usr/pub/eqnchar [ files }]| nroff [ options ] 

DESCRIPTION | | 
Egqnchar contains troff and nroff character definitions for constructing characters that are not available on 
the Graphic Systems typesetter. These definitions are primarily intended for use with eqn and neqn. It 
contains definitions for the following characters 


ciplus © // // square 
citimes © langle { circle oO 
wig ~ rangle } blot Oo 
-wig f hbar i bullet =e 
wig = 2 ppd 4 prop ee 
<wig < <-> = empty © 
=wig = <=> <> member € 
Star * l[< ¢ nomem ¢€ 
bigstar x /> } cup U 
=dot = ang is cap nN 
orsign Y rang L incl L 
andsign A 3dot : . subset Cc 
=del A thf = supset > 
oppA ¥ quarter % fsubset ¢ 
oppE A 3quarter % !supset 2 
angstrom A degree ° 

_ FILES | 
/usr/pub/eqnchar 

SEE ALSO 


troff(1), eqn(1) 
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hier — filesystem hierarchy 


DESCRIPTION 


The following outline gives a quick tour through a representative directory hierarchy. 


/ 


/vmunix 


root 


the kernel binary (UNIX itself) 


Aost+found 


/dev/ 


/bin/ 


/ib/ 


lete/ 


1 August 1985 


directory for connecting detached files for fsck(8) 
devices(4) 
MAKEDEV 
Shell script to create special files 
MAKEDEV.local 
site-specific part of MAKEDEV 
console main console, tty(4) 
tty* terminals, tty(4) 
hp* _— disks, hp(4) 
rhp* raw disks, hp(4) 


utility programs, cf /usr/bin/ (1) 

as assembler 

cc C compiler executive, cf /lib/ccom, /lib/cpp, /lib/c2 
csh C shell 


object libraries, etc., cf /usr/lib/ 
libc.a system calls, standard I/O, etc. (2,3,3S) 


ccom Ccompiler proper 
cpp C preprocessor 
c2 C code improver 


essential data and maintenance utilities; sect (8) 
dump dump program, dump(8) 
passwd password file, passwd(5) 
group group file, group(5) 
motd message of the day, login(1) 
termcap description of terminal capabilities, termcap(5) 
ttytype table of what kind of terminal is on each port, ttytype(5) 
mtab mounted file table, mtab(5) 
dumpdates 

dump history, dump(8) 
fstab _ filesystem configuration table fstab(5) 
disktab disk characteristics and partition tables, disktab(5) 
hosts host name to network address mapping file, hosts(5) 
networks 

network name to network number mapping file, networks(5) 
protocols 

protocol name to protocol number mapping file, protocols(5) 
services network services definition file, services(5) 
remote names and description of remote hosts for tip(1C), remote(5) 
phones private phone numbers for remote hosts, as described in phones(5) 
ttys properties of terminals, ttys(5) 
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Isys/ 


/tmp/ 


/usr/ 


/usr 


1 August 1985 


UNIX Programmer’s Manual 


getty part of login, getty(8) ; 
init the parent of all processes, init(8) 
rc shell program to bring the system up 


_ re.local site-dependent portion of re 


cron __ the clock daemon, cron(8) 
mount mount(8) — 


system source 
DISTRIBUTION/ . 
files for making a new kernel 
h/ header (include) files 
conf/ — executable device drivers 
netinet/ network header files 
machine/ 
include files 
temporary files, usually on a fast device, cf /usr/tmp/ 
e* used by ed(1) 
ctm+ used by ec(1) 


general pupose directory, usually a mounted filesystem 
adm/ administrative information 

wtmp login history, utmp(S5) 

messages 

hardware error messages 

tracct phototypesetter accounting, troff(1) 

Ipacct _ line printer accounting Ipr(1) 

vaacct, vpacct 


Varian and Versatec accounting vpr(1), pac(8) 


/bin : 
utility programs, to keep /bin/ small 
tmp/ —_ temporaries, to keep /tmp/ small 
dic _ word lists, etc. 
words principal word list, used by look(1) 
spellhist 
history file for spell(1) 
games/ 
hangman . 
lib/ library for the games 
quiz.k/ what quiz(6) knows 
index category index 


africa countries and capitals 


include/ standard #include files 
a.out.h object file layout, a.out(5) 
_$tdio.h standard I/O, intro(3S) 
math.h (3M) 


sys/ system-defined layouts, cf /sys/h 
net/ _ symbolic link to sys/net 
machine/ 
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symbolic link to sys/machine 


isi/ graphics programs (WorkStations only) 
lib/ object libraries, etc., to keep /lib/ small 


atrun 
lint/ 


Sstruct/ 


font/ 
fonts/ 
uucp/ 


units 
eign 
man/ 


scheduler for at(1) 

utility files for lint 

lint({12] subprocesses for lint(1) 

llib-Ic dummy declarations for /lib/libc.a, used by lint(1) 
llib-im dummy declarations for /lib/libc.m 


passes of struct(1) 


macros for troff(1) 
tmac.an macros for man(7) 
tmac.s macros for ms(7) 


fonts for troff(1) 
ftR Times Roman 
ftB Times Bold 


fonts for graphics WorkStations (WorkStations only) 
programs and data for uucp(1C) 
L.sys remote system names and numbers 


uucico the real copy program 


conversion tables for units(1) 
list of English words to be ignored by ptx(1) 


volume 1 of this manual, man(1) 


man0O/ 


man1/ 


catl/ 


general 

intro _— introduction to volume 1, ms(7) format 
xx _ template for manual page 

chapter 1 

as.1 

mount. 1m 


preformatted pages for section 1 


msgs/ messages, cf msgs(1) 
bounds highest and lowest message 
new/ __ binaries of new versions of programs 


preserve/ 


editor temporaries preserved here after crashes/hangups 
public/ binaries of user programs - write permission to everyone 
spool/ delayed execution files 


at/ 
Ipd/ 


used by at(1) 

used by Ipr(1) 

lock present when line printer is active 

cf+ copy of file to be printed, if necessary 
df* daemon control file, Ipd(8) 
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doc/ 
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tf* transient control file, while Ipr is working 
uucp/ work files and staging area for uucp(1C) 
LOGFILE | 
summary log 
LOG.* log file for one transaction 
mail/ mailboxes for mail(1) 
name mail file for user name 
name Jock 
lock file while name is receiving mail 
secretmail/ 
like mail/ 
uucp/ work files and staging area for uucp(1C) 
LOGFILE > 
summary log 
LOG.* log file for one transaction 
mqueue/ 
mail queue for sendmail(8) 
initial working directory of a user, typically wd is the user’s login name 
profile set environment for sh(1), environ(7) 
project nature of the user’s work (used by finger(1)) 
cshrce __ startup file for csh(1) 
exrc _— Startup file for ex(1) 
~plan ___ the user’s short-term plans (used by finger(1)) 
netrc startup file for various network programs 
-msgsrc startup file for msgs(1) 
-mailrc startup file for mail(1) 
calendar 
user’s datebook for calendar(1) 
papers, mostly in volume 2 of this manual, typically in ms(7) format 
as/ assembler manual 
Cc C manual 


source programs for utilities, etc. (Note: Applicable only to source licensees.) 


bin/ 


usr.bin/ 


ucb 
games/ 
lib/ 


source of commands in /bin 
as/ assembler 
ar.c _—s source for ar(1) 


source for commands in /usr/bin 
troff/ source for nroff and troff(1) 
font’ _ source for font tables, /usr/lib/font/ 
‘ftR.c Roman 


term/ terminal characteristics tables, /usr/lib/term/ 
tab300.c , 
DASI 300 


source for programs in /usr/ucb 

source for /usr/games ; 
source for programs and archives in /lib 
libc/ © Cruntime library 
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csu/ startup and wrapup routines needed with every C program 
crt0.s regular startup 
mert0.s modified startup for cc —p 
sys/ system calls (2) 
access.s 
brk.s 


stdio/ standard I/O functions (3S) 
fgets.c 
fopen.c 


gen/ other functions in (3) 
abs.c 


net/ network functions in (3N) 
gethostbyname.c 


local/ source which is not normally distributed 

new/ —_ source for new versions of commands and library routines 
old/ source for old versions of commands and library routines 
ucb/ __ binaries of programs developed at UCB 


edit editor for beginners 
ex command editor for experienced users 


mail § mail reading/sending subsystem 
man _— on-line documentation 


pi Pascal translator 
px Pascal interpreter 


vi visual editor 
SEE ALSO 
Is(1), apropos(1), whatis(1), whereis(1), finger(1), which(1), ncheck(8), find(1), grep(1) 
BUGS 
The position of files is subject to change without notice. 
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NAME > 
mailaddr — mail addressing description 


DESCRIPTION . 
Mail addresses are based on the ARPANET protocol listed at the end of this manual page. These addresses 
are in the general format 


user@domain 
where a domain is a hierarchical dot separated list of subdomains. For example, the address 
eric@monet.Berkeley.ARPA 


is normally interpreted from right to left: the message should go to the ARPA name tables (which do not 
correspond exactly to the physical ARPANET), then to the Berkeley gateway, after which it should go to 
the local host monet. When the message reaches monet it is delivered to the user ‘‘eric’’. 


Unlike some other forms of addressing, this does not imply any routing. Thus, although this address is 
specified as an ARPA address, it might travel by an alternate route if that were more convenient or 
efficient. For example, at Berkeley the associated message would probably go directly to monet over the 
Ethernet rather than going via the Berkeley ARPANET gateway. 


Abbreviation. 


Under certain circumstances it may not be necessary to type the entire domain name. In general anything 
following the first dot may be omitted if it is the same as the domain from which you are sending the mes- 
sage. For example, a user on ‘‘calder.Berkeley.ARPA”’ could send to ‘‘eric@monet’’ without adding the 
** Berkeley.ARPA”’ since it is the same on both sending and receiving hosts. 


Certain other abbreviations may be permitted as special cases. For example, at Berkeley ARPANET hosts 
can be referenced without adding the ‘‘.ARPA’’ as long as their names do not conflict with a local host 
name. . 


Compatibility. 


Certain old address formats are converted to the new format to provide compatibility with the previous 
mail system. In particular, 


host:user 
is converted to . 

user@host 
to be consistent with the rep(1C) command. 
Also, the syntax: 

~ hostluser 
is converted to: 
| user@host. UUCP 


This is normally converted back to the ‘‘host!user’’ form before being sent on for compatibility with older 
UUCP hosts. 


The current implementation is not able to route messages automatically through the UUCP network. Until 
that time you must explicitly tell the mail system which hosts to send your message through to get to your 
final destination. 


Case Distinctions. 


Domain names (i.e., anything after the ‘‘@’’ sign) may be given in any mixture of upper and lower case 
with the exception of UUCP hostnames. Most hosts accept any combination of case in user names, with 
the notable exception of MULTICS sites. 
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Differences with ARPA Protocols. 


Although the UNIX addressing scheme is based on the ARPA mail addressing protocols, there are some 
significant differences. 


At the time of this writing DARPA is converting to real domains. The following rules may be useful: 


e The syntax ‘‘user@host.ARPA”’ is being split up into ‘‘user@host.COM”’, ‘‘user@host.GOV’’, and 
“‘user@host.EDU”’ for commercial, government, and educational institutions respectively. 


e The syntax ‘‘user@host’’ (with no dots) has traditionally referred to the ARPANET. In the future this 
semantic will not be continued — instead, the host will be assumed to be in your organization. You should 
start using one of the syntaxes above. 


e Host names of the form ‘“‘ORG-NAME”’ (e.g., MIT-MC or CMU-CS-A) will be changing to 
*““NAME.ORG.XXX”’ (where ‘XXX’ is COM, GOV, or EDU). For example, MIT-MC will change to 
MC.MIT.EDU. In some cases names will be split apart even if they do not have dashes. For example, 
USC-ISIF will probably change to F.ISLUSC.EDU. 


Route-addrs. 


Under some circumstances it may be necessary to route a message through several hosts to get it to the 
final destination. Normally this routing is done automatically, but sometimes it is desirable to route the 
message manually. Addresses which show these relays are termed ‘‘route-addrs.’’ These use the syntax: 


<@hosta,@hostb:user@hostc> 


This specifies that the message should be sent to hosta, from there to hostb, and finally to hostc. This path 
is forced even if there is a more efficient path to hostc. 


Route-addrs occur frequently on return addresses, since these are generally augmented by the software at 
each host. It is generally possible to ignore all but the ‘‘user@host’’ part of the address to determine the 
actual sender. 


Postmaster. 


Every site is required to have a user or user alias designated ‘‘postmaster’’ to which problems with the mail 
system may be addressed. 


Other Networks. 


Some other networks can be reached by giving the name of the network as the last component of the 
domain. This is not a standard feature and may not be supported at all sites. For example, messages to 
CSNET or BITNET sites can often be sent to ‘‘user@host.CSNET’’ or ‘‘user@host.BITNET’’ respec- 
tively. 


BERKELEY 
The following comments apply only to the Berkeley environment. 


What’s My Address? 
If you are on a local machine, say monet, your address is 
yourname@monet.Berkeley.ARPA 


However, since most of the world does not have the new software in place yet, you will have to give _ 
correspondents slightly different addresses. From the ARPANET, your address would be: 


yourname%monet@Berkeley.ARPA 
From UUCP, your address would be: 
ucbvax! yourname% monet 
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Computer Center. 


_ The Berkeley Computer Center is in a subdomain of Berkeley. Messages to the computer center should be 


addressed to: | 
user%host.CC@Berkeley. ARPA 
The alternate syntax: 
user@host.CC 


may be used if the message is sent from inside Berkeley. 


For the time being Computer Center hosts are known within the Berkeley domain, i.e., the ‘‘.CC’’ is 
optional. However, it is likely that this situation will change with time as both the Computer Sous 
department and the Computer Center grow. 


The RFC822 group syntax (‘‘group:userl,user2,user3;’’) is not supported except in the special case of 
**group:;’’ because of a conflict with old berknet-style addresses. 


Route-Address syntax is grotty. 
UUCP- and ARPANET-style addresses do not coexist politely. 


SEE ALSO 


mail(1), sendmail(8); Crocker, D. H., Standard for the Format of Arpa Internet Text Messages, RFC822. 
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NAME 
man — macros to typeset manual 
SYNOPSIS 
nroff -man fie ... 
troff —man file ... 
DESCRIPTION 
These macros are used to lay out pages of this manual. A skeleton page may be found in the file 
/usr/man/manO/xx. . 
Any text argument t may be zero to six words. Quotes may be used to include blanks in a ‘word’. If text is 
empty, special treatment is applied to the next input line with text to be printed. In this way .I may be used 
to italicize a whole line, or SM may be followed by .B to make small bold letters. 
A prevailing indent distance is remembered between successive indented paragraphs, and is reset to default 
value upon reaching a non-indented paragraph. Default units for indents i are ens. 
Type font and size are reset to default values before each paragraph, and after processing font and size set- 
ting macros. 
These strings are predefined by —man: 
\*R ‘®’, ‘(Reg)’ in nroff. 
\4S Change to default type size. 
FILES 
/usr/lib/tmac/tmac.an 
/usr/man/man0/xx 
SEE ALSO 
troff(1), man(1) 
BUGS 
Relative indents don’t nest. 
REQUESTS 
Request Cause If no Explanation 
Break Argument 
Bt no t=n.tl* Text tis bold. 
Bit no t=n.t.l. Join words of t alternating bold and italic. - 
BRt no t=n.tl. Join words of t alternating bold and Roman. 
DT no .Sili.. Restore default tabs. 
HPi yes i=p.i* Set prevailing indent to i. Begin paragraph with hanging indent. 
It no f¢=n.tl Text tis italic. . . 
Bt no t=n.tl. Join words of t alternating italic and bold. 
IP xi. yes x="" Same as .TP with tag x. 
JIRt no t=n.tl. Join words of ¢ alternating italic and Roman. 
.LP yes. - Same as .PP. 
PDd no d=.4v Interparagraph distance is d. 
PP yes - Begin paragraph. Set prevailing indent to .5i. 
RE yes - End of relative indent. Set prevailing indent to amount of starting .RS. 
RB t no f¢=n.t.l. Join words of ¢ alternating Roman and bold. 
RI t no =n.t.l. Join words of ¢ alternating Roman and italic. 
RS i yes i=p.i. Start relative indent, move left margin in distance i. Set prevailing indent to .5i for 
nested indents. 
Ht yes t=n.tl.  Subhead. 
SM ¢ no ¢=n.tl. Text tis small. — 
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Begin page named x of chapter c; x is extra commentary, e.g. ‘local’, for page foot - 
center; v alters page foot left, e.g. ‘4th Berkeley Distribution’; m alters page head 
center, e.g. ‘Brand X Programmer’s Manual’. Set prevailing indent and tabs to .5i. 
Set prevailing indent to i. Begin indented paragraph with hanging tag given by next 
text line. If tag doesn’t fit, place it on separate line. . 


+ nt. = next text line; p.i. = prevailing indent 
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NAME 
me — macros for formatting papers 


SYNOPSIS 
nroff —me [ options ] file ... 
troff —me [ options ] file ... 


DESCRIPTION 
This package of nroff and troff macro definitions provides a canned formatting facility for technical 
papers in various formats. When producing 2-column output on a terminal, filter the output through col(1). 


The macro requests are defined below. Many nroff and troff requests are unsafe in conjunction with this 
package, however, these requests may be used with impunity after the first .pp: 


-bp _ begin new page 

-br —_— break output line here 

Spn_ insert n spacing lines 

isn (line spacing) n=1 single, n=2 double space 
na __—ino alignment of right margin 

cen center next n lines 

.uln underline next n lines 

Sz +n add n to point size 


Output of the eqn, neqn, refer, and tbl(1) preprocessors for equations and tables is acceptable as input. 


FILES 
/usr/lib/tmac/tmac.e 
/usr/lib/me/* 
SEE ALSO | 
eqn(1), troff(1), refer(1), tbl(1) 
—me Reference Manual, Eric P. Allman 
Writing Papers with Nroff Using —me 
REQUESTS | 
In the following list, “‘initialization’’ refers to the first .pp, .Ip, .ip, np, .sh, or uh macro. This list is incom- 
plete; see The —me Reference Manual for interesting details. 


Request Initial Cause Explanation 


Value Break 
Ac - yes Begin centered block 
Ad - no _— Begin delayed text 
Af - no _— Begin footnote 
Al - yes Begin list 
(q - yes Begin major quote 
AKX - no _— Begin indexed item in index x 
(z - no _—C Begin floating keep 
Jc - yes Endcentered block 
.)d - yes End delayed text 
f - yes End footnote 
mB) - yes End list 
a] - yes End major quote 
Xx - yes End index item 
Jz - yes End floating keep 
++mH - no _ Define paper section. m defines the part of the paper, and can be C (chapter), A (appen- 


dix), P (preliminary, e.g., abstract, table of contents, etc.), B (bibliography), RC (chapters 
renumbered from page one each chapter), or RA (appendix renumbered from page one). 
+c T - yes Begin chapter (or appendix, etc., as set by .++). T is the chapter title. 
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Ic 1 yes One column format on a new page. 


we. 1 yes Twocolumn format. 

EN - yes Space after equation produced by eqn or neqn. 

EQxy - yes Precede equation; break out and add space. Equation number is y. The optional argument 
oo x may be J to indent equation (default), Z to left-adjust the equation, or C to center the 

equation. 

.GE - yes End gremlin picture. 

GS - yes Begin gremlin picture. 

PE - yes End pic picture. 

PS - yes Begin pic picture. 

.TE - yes End table. 

.TH © - yes End heading section of table. 

.TSx - yes Begin table; if x is H table has repeated heading. 

acAN - no _— Set up for ACM style output. A is the Author’s name(s), N is the total number of pages. 

: Must be given before the first initialization. 
bx no no_ Print x in boldface; if no argument switch to boldface. 
-ba +n 0 yes Augments the base indent by n. This indent is used to set the indent on regular text (like 
paragraphs). 

-bc no yes Begin newcolumn 

bix no no _ Print x in bold italics (nofill only) 

bu - yes Begin bulleted paragraph 

.bx x no no _ Print x ina box (nofill only). 

ef “x’y’z° °° no  Setevenfootertox y z 

eh x ‘yr “re no Set even header tox y z 

fo xyz" °°’ no Setfootertox y z 

hx - no _—_- Suppress headers and footers on next page. 

che x‘yz° °°’ no  Setheadertox y z 

hl - yes Draw ahorizontal line 

Ax no no __Italicize x; if x missing, italic text follows. 

ipxy no yes Start indented paragraph, with hanging tag x. Indentation is y ens (default 5). 

Ap yes yes Start left-blocked paragraph. 

lo - no __ Read in a file of local macros of the form .*x. Must be given before initialization. 

np 1 yes Start numbered paragraph. 

of “x*yz" °°’? no  Setodd footertox y z 

oh X‘y’2° °°? no  Setoddheadertox y z 

pd - yes Print delayed text. 

pp no yes _ Begin paragraph. First line indented. 

I yes no Roman text follows. 

re - no Reset tabs to default values. 

SC no no. Read ina file oF special characters and diacritical marks. Must be given before initializa- 

tion. . 
shnx - yes Section head follows, font automatically bold. 7 is level of section, x is title of section. 
_ Sk - mo. no_. Leave the next page blank. Only one page is remembered ahead. 

smx - no  Setx ina smaller pointsize. 

SZ +2 10p no  Augment the point size by n points. 

th no no _~— Produce the paper in thesis format. Must be given before initialization. 

tp no yes Begin title page. 

Ux - no _- Underline argument (even in ‘roff). (Nofill only). 

uh - yes Like .sh but unnumbered. 

Xp x - no __—~wPrint index x. 
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NAME 
ms — text formatting macros 


SYNOPSIS 
nroff —ms [ options ] file ... 
troff —ms [ options ] file ... 


DESCRIPTION 
This package of nroff and troff macro definitions provides a formatting facility for various styles of arti- 
cles, theses, and books. When producing 2-column output on a terminal or lineprinter, or when reverse line 
motions are needed, filter the output through col(1). All external —ms macros are defined below. Many 
nroff and troff requests are unsafe in conjunction with this package. However, the first four requests 
below may be used with impunity after initialization, and the last two may be used even before initializa- 
tion: ; 
.bp begin new page 
.br break output line 
spn _ insert n spacing lines 
cen center next n lines 
isn _ line spacing: n=1 single, n=2 double space 
na no alignment of right margin . 
Font and point size changes with \f and \s are also allowed; for example, ‘‘\flword\fR’’ will italicize word. 
Output of the tbl, eqn, and refer (1) preprocessors for equations, tables, and references is acceptable as 
input. 
FILES 
/usr/lib/tmac/tmac.x 
/usr/lib/ms/x.??? 
SEE ALSO 
eqn(1), refer(1), tbI(1), troff(1) 
REQUESTS 


Macro Initial Break? Explanation 
Name Value Reset? 


AB x - y begin abstract; if x=no don’t label abstract 
AE - y end abstract 

Al - y author’s institution 

AM - n better accent mark definitions 

AU = y author’s name 

Bx - n embolden x; if no x, switch to boldface 

Bl - y begin text to be enclosed in a box 

.B2 - y end boxed text and print it 

BT date n bottom title, printed at foot of page 

BX x - n print word x in a box 

.CM if t n cut mark between pages 

CT y,y Chapter title: page number moved to CF (TM only) 
DA x if n n force date x at bottom of page; today if no x 
DE - y end display (unfilled text) of any kind 
DSxy I y begin display with keep; x =I,L,C,B; y =indent 
Dy 8n,.5i yy indented display with no keep; y =indent 
LD - y left display with no keep 

.CD - y centered display with no keep 

.BD - y block display; center entire block 

EF x - n even page footer x (3 part as for .tl) 

EH x - n = _even page header x (3 part as for .tl) 
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end displayed equation produced by eqn 

break out equation; x =L,1,C; y =<equation number 
end footnote to be placed at bottom of page 
numbered foomote paragraph; may be redefined 
Start footnote; x is optional footnote label 
optional page header below header margin 
italicize x ; if no x, switch to italics 

indented paragraph, with hanging tag x ; y =indent 
index words x y and so on (up to 5 levels) 

end keep of any kind 
begin floating keep; text fills remainder of page 
begin keep; unit kept together on a single page 


larger; increase point size by 2 


left (block) paragraph. 

multiple columns; x =column width 

no date in page footer; x is date on cover 

numbered header; x =level, x =0 resets, x=S sets to y 
set point size back to normal 


- odd page footer x (3 part as for .tl) 


odd page header x (3 part as for .tl) 

print header on 1st page 

paragraph with first line indented 

page title, printed at head of page 

print index (table of contents); x =no suppresses title 
quote paragraph (indented and shorter) 

return to Roman font 

retreat: end level of relative indentation 

released paper format; x =no stops title on Ist page 
right shift: start level of relative indentation 
section header, in boldface 

smaller; decrease point size by 2 

Set tabs to 8n 16n ... (nroff) Sn 10n.... (troff) 

print table of contents at end; x =no suppresses title 
end of table processed by tbl 

end multi-page header of table 

title in boldface and two points larger 

UC Berkeley thesis mode 

begin table; if x =H table has multi-page header 
underline x, even in troff 

UNIX; trademark message first time; x appended 


another index entry; x =page or no for none; y =indent 


end index entry (or series of .[X entries) 

paragraph with first line exdented, others indented 
begin index entry; x =page or no for none; y =indent 
one column format, on a new page 

begin two column format 

beginning of refer reference 

end of unclassifiable type of reference 

N= 1:journal-article, 2:book, 3:book-article, 4:report 
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REGISTERS 
Formatting distances can be controlled in —ms by means of built-in number registers. For example, this 
sets the line length to 6.5 inches: 


nr LL 6.5i 
Here is a table of number registers and their default values: 
Name Register Controls Takes Effect Default 


PS ___ point size paragraph 10 

VS __ vertical spacing paragraph 12 

LL siine length paragraph  6i 

LT title length next page same as LL 

FL footmote length next FS 5.5i 

PD paragraph distance paragraph _1v (if n), .3v (if t) 

DD display distance displays iv (if n), .5v (if t) 
PI patagraph indent paragraph Sn 

QI —_ quote indent next.QP Sn 

FI  footmote indent next FS 2n 

PO page offset next page 0 (ifn), ~1i (if t) 

HM _header margin next page li 

FM footer margin nextpage li 

FF footnote format next FS 0 (1, 2, 3 available) 


When resetting these values, make sure to specify the appropriate units. Setting the line length to 7, for 
example, will result in output with one character per line. Setting FF to 1 suppresses footnote superscript- 
ing; setting it to 2 also suppresses indentation of the first line; and setting it to 3 produces an .IP-like foot- 
note paragraph. 


Here is a list of string registers available in —-ms; they may be used anywhere in the text: 


Name String’s Function 

\*Q quote (" in nroff, ‘‘ in troff ) 
\¥U unquote (" in nroff, ’’ in troff ) 
\*— dash (-- in nroff, — in troff ) 
\*(MO month (month of the year) 
\*(DY day (current date) 

\#* automatically numbered footnote 
\*" acute accent (before letter) 

\** grave accent (before letter) 

\*, circumflex (before letter) 

\*, cedilla (before letter) 

\*: umlaut (before letter) 

\*. tilde (before letter) 


When using the extended accent mark definitions available with .AM, these strings should come after, 
rather than before, the letter to be accented. 


BUGS 
Floating keeps and regular keeps are diverted to the same space, so they cannot be mixed together with 
predictable results. 
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NAME — | 
term — conventional names for terminals 


DESCRIPTION 
Certain commands use these terminal names. They are maintained as part of the shell environment (see 
sh(1),environ(7)). 


adm3a —s— Lear Seigler Adm-3a 

2621 Hewlett-Packard HP262? series terminals 

hp _ Hewlett-Packard HP264? series terminals 

c100 Human Designed Systems Concept 100 

h19 Heathkit H19 

mime Microterm mime in enhanced ACT IV mode 
1620 DIABLO 1620 (and others using HyType IT) 
300 DASI/DTC/GSI 300 (and others using HyType I) 


33°53 TELETYPE® Model 33 

37 TELETYPE Model 37 

43 TELETYPE Model 43 

735 Texas Instruments T1735 (and T1725) 
745 Texas Instruments T1745 


dumb terminals with no special features 
dialup a terminal on a phone line with no known characteristics 
- fetwork a terminal on a network connection with no known characteristics 
4014 Tektronix 4014 
vt52 Digital Equipment Corp. VTS2 


The list goes on and on. Consult /etc/termcap (see termcap(5)) for an up-to-date and locally correct list. 


Commands whose behavior may depend on the terminal either consult TERM in the environment, or 
accept arguments of the form —Tterm, where term is one of the names given above. 


SEE ALSO 
stty(1), tabs(1), plot(1G), sh(1), environ(7) ex(1), clear(1), more(1), ul(1), tset(1), termcap(5), 
termcap(3X), ttytype(5S) 
See troff(1) for information on nroff 


BUGS 
The programs that ought to adhere to this nomenclature do so only fitfully. 
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a | DOCUMENTATION COMMENTS. . 


Please take a minute to comment on the accuracy and completeness of this manual. Your assistance will help us 
to better identify and respond to specific documentation issues. If necessary, you may attach an additional page 
with comments. Thank you in advance for your cooperation. 


Manual Title: UNIX User Ref. Manual (URM) Part Number: 490143 Rev. A 
nar Name: Title: 
Company: Phone: ( ) 
Address: 
City: State: Zip Code: 


1. Please rate this manual for the following: 
Poor Fair Good Excellent 


Clarity Oo Oo 0 Oo 
- Completeness o Oo 0 0 
- Organization Oo Oo Oo 0 
Technical Content/Accuracy Oo | Oo 0 
Readability o Oo o Oo 


Please comment: 


2. Does this manual contain enough examples and figures? 
Yes O NoO 


Please comment: 


3. Is any information missing from this manual? 
YesO NoO 


Please comment: 


4. Is this manual adequate for your purposes? 
Yes 0 NoO 


Please comment on how this manual can be improved: 
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